English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt
The open source AI coding agent — Kilo on OpenCode v2.
Important
This branch is a development preview, not the released Kilo product or an in-place v1 upgrade. It preserves the original Kilo interface while migrating the runtime to v2. The preview uses separate
kilo2storage; imports are explicit. Existing v1 data is not migrated automatically.
Installation
Use Bun 1.4 or newer. From this checkout, install dependencies, then choose the CLI or VS Code workflow below. A fresh dependency installation and all platforms have not yet completed release validation. Published npm packages and Marketplace releases do not install this branch.
bun install
CLI
Open the interactive Kilo CLI. Arguments can specify a project directory, for example bun run dev /path/to/project.
bun run dev
VS Code
Build and open the original Kilo extension in an isolated VS Code development profile. Install VS Code locally and put code on PATH, or set VSCODE_BIN. The extension starts its local server automatically. The extension port is still incomplete.
bun run extension
Agents
Code implements changes. Plan investigates, challenges assumptions, saves a plan, and offers an implementation handoff. Ask answers without editing files. Debug investigates problems. Custom agents remain configurable. Names describe behavior; available tools and permissions depend on configuration.
What it does
Implemented slices include native conversations, tools and permissions, Gateway model/account integration, settings, memory, indexing, sandbox integration, and terminal adapters. Full original VS Code parity, JetBrains, autocomplete/FIM, speech, and some cloud workflows remain unfinished. Sharing, remote-service deployment checks, signing, and cross-platform distribution still have open gates. Source presence is not end-to-end acceptance.
Documentation
Start with the migration plan and test plans for this branch's status. The general Kilo documentation describes the released product and may differ from this preview.
- Developer overview — repository layout, core concepts, execution flows, builds, upstream dependencies, and CI gates.
- Migration progress (#13750)
- Migration tracking
- Kilo
Contributing
Contributions are welcome. Read the contributing guide and v2 fork conventions before changing shared code. Keep Kilo behavior in owned packages where possible; verify affected packages and preserve upstream attribution.
License
FAQ
Where did Kilo CLI come from?
Kilo CLI is a fork of OpenCode, enhanced to work within the Kilo agentic engineering platform.