README

Important: main is not accepting new features

All new feature pull requests must target the v2 branch. Bug fixes for the current release may still go to main.


  English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt



  


The open source coding agent for building with AI in VS Code, JetBrains, or the CLI.


  
  
  
  
  
  


!Kilo-in-VS-Code-and-CLI

---

Kilo Code is an AI coding agent that meets you everywhere you work: VS Code, JetBrains, and the CLI. It's open source with open pricing. You pick from 500+ models, switch between them mid-task, and pay the model provider's rate with zero markup. No API keys required to start.

 Installation

Pick where you want to run Kilo.


VS Code



Install the Kilo Code extension directly, or grab it from the VS Code Marketplace. Create an account and you'll have access to 500+ models including GPT-6 Astra, Claude Fable 5.1, Gemini 3.8 Flash, Grok 4.6, and DeepSeek V4.1 Flash, all at provider pricing.




CLI



bash
 npm
npm install -g @kilocode/cli

 curl
curl -fsSL https://kilo.ai/cli/install | bash

 pnpm
pnpm add -g @kilocode/cli

 bun
bun add -g @kilocode/cli

 Homebrew (macOS / Linux)
brew install Kilo-Org/tap/kilo

 Arch Linux (AUR)
paru -S kilo-bin


Then run kilo in any project directory to start.




JetBrains



Install the Kilo Code plugin from the JetBrains Marketplace, or search "Kilo Code" in Settings → Plugins inside any JetBrains IDE.




Cloud Agent



Run Kilo from the web, no local machine needed, at app.kilo.ai/cloud.




Code Reviews



Set up automated AI code reviews on your pull requests at app.kilo.ai/code-reviews.




Install the CLI from GitHub Releases (binaries)

Download the latest binary from the Releases page.

| Platform | Asset |
|---|---|
| Windows (most PCs) | kilo-windows-x64.zip |
| macOS (Apple Silicon) | kilo-darwin-arm64.zip |
| macOS (Intel) | kilo-darwin-x64.zip |
| Linux x64 | kilo-linux-x64.tar.gz |
| Linux ARM | kilo-linux-arm64.tar.gz |

Notes: x64-baseline is a compatibility build for older CPUs without AVX. musl is the statically linked build for Alpine or minimal Docker images without glibc. kilo-vscode-.vsix is the VS Code extension package, not the CLI. Source code archives are for building from source.



 Agents

Kilo ships with specialized agents you switch between depending on the task. You can also build your own custom agents.

- Code - The default. Implements and edits code from natural language.
- Plan - Designs architecture and writes implementation plans before any code gets written.
- Ask - Answers questions about your codebase without touching any files.
- Debug - Troubleshoots and traces issues.

Learn more about agents and custom agents.

 What it does

- Code generation from natural language, across multiple files.
- Inline autocomplete with ghost-text suggestions and tab to ac