Takumi VS Code Bridge 🌉🤖 The official Visual Studio Code integration for Takumi — your personal, multi-agent AI software agency. This extension acts as a secure, high-speed WebSocket bridge between your local VS Code environment and the Takumi AI engine. It allows Takumi's specialized agents (CTO, Product Manager, Frontend, Backend, and DevOps) to see your project and write code directly to your editor in real-time. ✨ Features Real-Time Workspace Sync: Takumi instantly reads your project's file structure so it always knows exactly what you're working on. Smart Context Filtering: Automatically ignores heavy, irrelevant folders like node_modules, venv, and .git to save on token usage and keep the AI strictly focused on your source code. Direct Code Injection: Watch as Takumi's agents automatically create folders, scaffold boilerplates, and write multi-file features directly onto your hard drive. No more copy-pasting. Automated Terminal Commands: Takumi can execute required terminal commands to install dependencies (e.g., npm install, pip install -r requirements.txt) and spin up your development servers. Self-Healing (Auto-Fix): When errors happen, the Healer Agent can read your files and terminal output to diagnose and apply fixes automatically. 🚀 How It Works Takumi isn't just a generic chatbot; it's a team of AI agents. This extension provides the "hands" and "eyes" for that team on your local machine. You type a prompt in the Takumi Web App (e.g., "Build a React dashboard with a Flask backend"). The Takumi Backend formulates an execution plan. The Bridge Extension receives the commands and safely executes them in your active VS Code workspace. 🛠️ Getting Started Open your project folder in VS Code. Start the extension (via the Command Palette Ctrl+Shift+P or Cmd+Shift+P -> Takumi: Start Bridge). Ensure your local Takumi Backend server (Django) is running. Open the Takumi Web Interface in your browser. Start chatting! The web interface will automatically connect to your VS Code session. 🔒 Security & Safety Your code never leaves your machine unless explicitly sent to the AI for generation purposes. Action Sandbox: The extension only modifies files within your currently active VS Code Workspace. Path Validation: Strict sanitization ensures AI agents cannot access parent directories or sensitive system files outside of your project base directory. 📝 Requirements A running instance of the Takumi backend (Python/Django). Valid API Keys configured in your Takumi .env file (OpenAI/NVIDIA/Gemini). 💬 Feedback & Support This is an early Alpha release. If you run into issues, please report them to the development team or trigger the Healer Agent to see if Takumi can fix its own bugs! |