Skip to content
This repository was archived by the owner on Feb 25, 2026. It is now read-only.

README.md

Latest commit

 

History

History
90 lines (61 loc) · 3.66 KB

README.md

File metadata and controls

90 lines (61 loc) · 3.66 KB

Kilo CLI logo

The open source AI coding agent.

Discord X Reddit

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:

Installation

bun install
bun dev . # starts Kilo CLI in the current directory; use a different path to start in another repository

This will open Kilo CLI in your terminal

  1. Type /connect to setup your Provider
  2. Select your desired Provider from the list - this will trigger authentication with that Provider
  3. After authentication, return to Kilo CLI to select your Model and you're done!

Key Features

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:

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