kilocode/README.md

<img width="120" src="assets/icons/logo-outline-black.png" alt="Kilo Code logo">

Kilo Code

Kilo Code is an open-source AI agent extension for Visual Studio Code. It helps you write code more efficiently by generating code, automating tasks, and providing suggestions.

Get started with $20 of free credits to experience the power of Gemini 2.5 Pro, Claude 3.7 Sonnet, and GPT-4.1. We'll give out more free tokens if you leave useful feedback.

• VS Code Marketplace (download)
• Home page (learn more)
• Discord (join community)
• Reddit (start discussing)
• Substack (blog)
• Product Hunt (vote)

Key Features

• Code Generation: Generate code using natural language.
• Task Automation: Automate repetitive coding tasks.
• Automated Refactoring:: Refactor and improve existing code.
• MCP Servers: Use MCP servers to extend the agent capabilities.

Get Started in 2 Minutes

1. Install the Kilo Code extension from the VS Code Marketplace.
2. Log in with your Google Account to get $20 in free Claude 3.7 Sonnet credits.
3. Start coding!

Local Setup & Development

1. Clone the repo:

   git clone https://github.com/Kilo-Org/kilocode.git
   

2. Install dependencies:

   npm run install:all
   

3. Build the extension:

   npm run build
   

   • A .vsix file will appear in the bin/ directory.

4. Install the .vsix manually if desired:

   code --install-extension bin/kilo-code-4.0.0.vsix
   

5. Start the webview (Vite/React app with HMR):

   npm run dev
   

6. Debug:

   • Press F5 (or Run → Start Debugging) in VSCode to open a new session with Kilo Code loaded.

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