Skip to content

SolaceHarmony/Thea-Code

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

English • CatalàDeutschEspañolFrançaisहिन्दीItaliano

日本語한국어PolskiPortuguês (BR)TürkçeTiếng Việt简体中文繁體中文

Welcome to Thea Code - A Community of Innovators

Thea Code is not just an AI tool; it's a dynamic platform powered by the creativity and collaboration of its community. Whether you're a seasoned developer or just starting, your contributions help shape the future of AI-driven coding tools.


Join the Thea Code Community

By joining the Thea Code community, you become part of a global network of innovators. Share your ideas, contribute code, and explore the vast possibilities of AI-enhanced development.

Connect with developers, contribute ideas, and stay ahead with the latest AI-powered coding tools.

Join Discord Join Reddit



Thea Code

Feature Requests Documentation

Thea Code is an AI-powered autonomous coding agent that lives in your editor. It can:

  • Communicate in natural language
  • Read and write files directly in your workspace
  • Run terminal commands
  • Automate browser actions
  • Integrate with any OpenAI-compatible or custom API/model
  • Use any model that supports function calling or MCP with unified tool access
  • Work with Computer Use on any model supporting vision and function calling
  • Adapt its “personality” and capabilities through Custom Modes

Whether you’re seeking a flexible coding partner, a system architect, or specialized roles like a QA engineer or product manager, Thea Code can help you build software more efficiently.

Check out the CHANGELOG for detailed updates and fixes.

🚀 Universal Tool Integration

Thea Code features Model Context Protocol (MCP) integration across all 16 active AI providers, providing:

  • Unified tool access across OpenAI, Anthropic, Ollama, and all other supported providers
  • Automatic format conversion supporting XML, JSON, and OpenAI function call formats
  • Computer Use capabilities with any vision-enabled model
  • Extensible tool system via MCP for unlimited custom functionality

Note: Thea Code is a fork of Roo Code. We'd like to express our special thanks to the Roo Code team for their excellent work which served as the foundation for this project.


🎉 Thea Code 0.0.5 Released

Thea Code 0.0.5 brings the initial release of this community fork!

  • Initial fork from Roo Code with rebranding
  • Updated documentation to reflect the new project identity
  • Fixed references in contributing guidelines
  • Maintained compatibility with existing features and functionality

What Can Thea Code Do?

  • 🚀 Generate Code from natural language descriptions
  • 🔧 Refactor & Debug existing code
  • 📝 Write & Update documentation
  • 🤔 Answer Questions about your codebase
  • 🔄 Automate repetitive tasks
  • 🏗️ Create new files and projects

Quick Start

  1. Install Thea Code from the VS Code marketplace or build from source
  2. Connect Your AI Provider - Configure OpenAI, Anthropic, Ollama, or any compatible API
  3. Start Coding - Use natural language to interact with your codebase

Key Features

Multiple Modes

Thea Code adapts to your needs with specialized modes:

  • Code Mode: For general-purpose coding tasks
  • Architect Mode: For planning and technical leadership
  • Ask Mode: For answering questions and providing information
  • Debug Mode: For systematic problem diagnosis
  • Custom Modes: Create unlimited specialized personas for security auditing, performance optimization, documentation, or any other task

Smart Tools & MCP Integration

Thea Code comes with powerful tools that work across all AI providers:

  • Read and write files in your project
  • Execute commands in your VS Code terminal
  • Control a web browser for automated testing and interaction
  • Computer Use capabilities with vision-enabled models
  • External tool integration via MCP (Model Context Protocol)

Model Context Protocol (MCP) extends Thea Code's capabilities by providing:

  • Universal tool access across all 16 supported AI providers
  • Automatic format conversion between XML, JSON, and OpenAI function call formats
  • Seamless integration - tools work the same way regardless of your chosen AI provider
  • Extensible architecture - add unlimited custom tools for your specific workflow

Whether you're using OpenAI, Anthropic Claude, Ollama, or any other supported provider, all tools work consistently. MCP provides the framework to expand Thea Code's functionality to meet your specific needs - integrate with external APIs, connect to databases, or create specialized development tools.

Customization

Make Thea Code work your way with:

  • Custom Instructions for personalized behavior
  • Custom Modes for specialized tasks
  • Local Models for offline use
  • Auto-Approval Settings for faster workflows

Resources

Documentation

Community


Local Setup & Development

  1. Clone the repo:
git clone https://github.com/SolaceHarmony/Thea-Code.git
  1. Install dependencies:
npm run install:all
  1. Start the webview (Vite/React app with HMR):
npm run dev
  1. Debug: Press F5 (or RunStart Debugging) in VSCode to open a new session with Thea Code loaded.

Changes to the webview will appear immediately. Changes to the core extension will require a restart of the extension host.

Alternatively you can build a .vsix and install it directly in VSCode:

npm run build

A .vsix file will appear in the bin/ directory which can be installed with:

code --install-extension bin/thea-code-<version>.vsix

We use changesets for versioning and publishing. Check our CHANGELOG.md for release notes.


Disclaimer

Please note that Solace Projectdoes not make any representations or warranties regarding any code, models, or other tools provided or made available in connection with Thea Code, any associated third-party tools, or any resulting outputs. You assume all risks associated with the use of any such tools or outputs; such tools are provided on an "AS IS" and "AS AVAILABLE" basis. Such risks may include, without limitation, intellectual property infringement, cyber vulnerabilities or attacks, bias, inaccuracies, errors, defects, viruses, downtime, property loss or damage, and/or personal injury. You are solely responsible for your use of any such tools or outputs (including, without limitation, the legality, appropriateness, and results thereof).


Contributing

We love community contributions! Get started by reading our CONTRIBUTING.md.


Contributors

Thanks to all our contributors who have helped make Thea Code better!

We welcome and appreciate contributions from the community. The Thea Code project is maintained by the Solace Harmony team and community contributors.

Special thanks to the original Roo Code contributors whose work provided the foundation for this project.

License

Apache 2.0 © 2025 Solace Project


Enjoy Thea Code! Whether you keep it on a short leash or let it roam autonomously, we can’t wait to see what you build. If you have questions or feature ideas, drop by our Reddit community or Discord. Happy coding!

About

AI-powered coding plugin with tool auto-detection, OpenAI style function/vision support, and multi-model bridges (JSON, XML, MCP).

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 125