Catriel Müller
f259b6a90b
Remove 8 hosted platform packages that are not needed for the CLI-focused fork: - infra/ (SST infrastructure) - packages/console/ (console web app + backend) - packages/enterprise/ (enterprise/teams platform) - packages/web/ (Astro documentation site) - packages/slack/ (Slack integration) - packages/function/ (API workers) - packages/docs/ (static docs) - packages/identity/ (brand assets) Update upstream merge configuration to prevent these packages from being re-added during future merges from opencode upstream: - Add all deleted folders/files to skipFiles in config.ts - Add Vouch-related files to skip list (VOUCHED.md, vouch workflows) - Update transform-package-json.ts to preserve Kilo's workspace config - Remove slack/web references from transform lists Update supporting files: - Remove console/* and slack from package.json workspaces - Remove sst and @aws-sdk/client-s3 dependencies - Update AGENTS.md package references - Clean .prettierignore of deleted package references - Add logs/.gitignore to keep folder empty Result: 310,297 lines deleted, 11 npm packages removed, typecheck passing
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 |
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.