Marius
46e06264da
* tmp * tmp * tmp * feat(agent-manager): add fixed local session tab with branch display and persistence Add a dedicated local session item at the top of the agent manager sidebar that always runs in the main repo (never a worktree). The local session persists across panel reopens via vscode webview state, shows the current git branch name (refreshed on click), and supports keyboard navigation. Extract navigation logic into a pure testable function with 16 unit tests. * fix(agent-manager): invalidate stale persisted localSessionID on recovery The local session ID was persisted to webview state but never checked against the actual sessions list on recovery. If the session was deleted or expired between VS Code reloads, the UI would get stuck selecting a ghost session with no way to recover.
The open source AI coding agent.
Installation
# npm
npm install -g @kilocode/cli
# Or run directly with npx
npx @kilocode/cli
Then run kilo in any project directory to start.
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.
Autonomous Mode (CI/CD)
Use the --auto flag with kilo run to enable fully autonomous operation without user interaction. This is ideal for CI/CD pipelines and automated workflows:
kilo run --auto "run tests and fix any failures"
Important: The --auto flag disables all permission prompts and allows the agent to execute any action without confirmation. Only use this in trusted environments like CI/CD pipelines.
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 |
MCP servers are configured in ~/.config/kilo/opencode.json (or opencode.jsonc; on Windows the config directory may be under %USERPROFILE% depending on your environment). Use a top-level "mcp" object: each key is a server name, value is type: "local" and command: ["executable", "arg1", ...]. Optional per-server: environment, enabled, timeout. Restart the CLI after editing for changes to take effect. (Path from packages/opencode/src/global/index.ts; schema in config.ts McpLocal.)
Default mode mappings:
code→buildagentarchitect→planagent
For detailed migration information, see:
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.