The open source AI coding agent.

---

Installation

npm i -g @kilocode/cli        # or bun/pnpm/yarn

Agents

Kilo CLI includes two built-in agents you can switch between using the Tab key:

• build - Default, full access agent for development work
• plan - Read-only agent for analysis and code exploration
  • Denies file edits by default
  • Asks permission before running bash commands
  • Ideal for exploring unfamiliar codebases or planning changes

Also included is a general subagent for complex searches and multi-step tasks. This is used internally and can be invoked using @general in messages.

Migrating from Kilo Code Extension

If you're coming from the Kilo Code VS Code extension, your configurations are automatically migrated:

Kilo Code Feature	Kilo CLI Equivalent
Custom modes	Converted to agents
Rules (.kilocoderules, .kilocode/rules/)	Added to instructions array
Skills (.kilocode/skills/)	Auto-discovered alongside .opencode/skill/
Workflows (.kilocode/workflows/)	Converted to commands
MCP servers	Migrated to mcp config

Default mode mappings:

• code → build agent
• architect → plan agent

For detailed migration information, see:

• Migration Overview
• Rules Migration

Documentation

For more info on how to configure Kilo CLI, head over to our docs.

Contributing

If you're interested in contributing, please read our contributing docs before submitting a pull request.

FAQ

Where did Kilo CLI come from?

Kilo CLI is a fork of OpenCode, enhanced to work within the Kilo agentic engineering platform.

---

Join our community Discord | X.com | Reddit