CLI Command Reference

start ACP (Agent Client Protocol) server

Options:
  --help         Show help  [boolean]
  --version      Show version number  [boolean]
  --port         port to listen on  [number] [default: 0]
  --hostname     hostname to listen on  [string] [default: "127.0.0.1"]
  --mdns         enable mDNS service discovery (defaults hostname to 0.0.0.0)  [boolean] [default: false]
  --mdns-domain  custom domain name for mDNS service (default: kilo.local)  [string] [default: "kilo.local"]
  --cors         additional domains to allow for CORS  [array] [default: []]
  --cwd          working directory  [string] [default: "."]

manage MCP (Model Context Protocol) servers

Commands:
  kilo mcp add            add an MCP server
  kilo mcp list           list MCP servers and their status  [aliases: ls]
  kilo mcp auth [name]    authenticate with an OAuth-enabled MCP server
  kilo mcp logout [name]  remove OAuth credentials for an MCP server
  kilo mcp debug <name>   debug OAuth connection for an MCP server

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

add an MCP server

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

list MCP servers and their status

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

authenticate with an OAuth-enabled MCP server

Commands:
  kilo mcp auth list  list OAuth-capable MCP servers and their auth status  [aliases: ls]

Positionals:
  name  name of the MCP server  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

list OAuth-capable MCP servers and their auth status

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

remove OAuth credentials for an MCP server

Positionals:
  name  name of the MCP server  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

debug OAuth connection for an MCP server

Positionals:
  name  name of the MCP server  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

start kilo tui

Positionals:
  project  path to start kilo in  [string]

Options:
      --help         Show help  [boolean]
      --version      Show version number  [boolean]
      --port         port to listen on  [number] [default: 0]
      --hostname     hostname to listen on  [string] [default: "127.0.0.1"]
      --mdns         enable mDNS service discovery (defaults hostname to 0.0.0.0)  [boolean] [default: false]
      --mdns-domain  custom domain name for mDNS service (default: kilo.local)  [string] [default: "kilo.local"]
      --cors         additional domains to allow for CORS  [array] [default: []]
  -m, --model        model to use in the format of provider/model  [string]
  -c, --continue     continue the last session  [boolean]
  -s, --session      session id to continue  [string]
      --fork         fork the session when continuing (use with --continue or --session)  [boolean]
      --cloud-fork   fetch session from cloud and continue locally (use with --session)  [boolean]
      --prompt       prompt to use  [string]
      --agent        agent to use  [string]

attach to a running kilo server

Positionals:
  url  http://localhost:4096  [string]

Options:
      --help        Show help  [boolean]
      --version     Show version number  [boolean]
      --dir         directory to run in  [string]
  -c, --continue    continue the last session  [boolean]
  -s, --session     session id to continue  [string]
      --fork        fork the session when continuing (use with --continue or --session)  [boolean]
      --cloud-fork  fetch session from cloud and continue locally (use with --session)  [boolean]
  -p, --password    basic auth password (defaults to KILO_SERVER_PASSWORD)  [string]

run kilo with a message

Positionals:
  message  message to send  [string] [default: []]

Options:
      --help      Show help  [boolean]
      --version   Show version number  [boolean]
      --command   the command to run, use message for args  [string]
  -c, --continue  continue the last session  [boolean]
  -s, --session   session id to continue  [string]
      --fork      fork the session before continuing (requires --continue or --session)  [boolean]
      --share     share the session  [boolean]
  -m, --model     model to use in the format of provider/model  [string]
      --agent     agent to use  [string]
      --format    format: default (formatted) or json (raw JSON events)  [string] [choices: "default", "json"] [default: "default"]
      --auto      auto-approve all permissions (for autonomous/pipeline usage)  [boolean] [default: false]
  -f, --file      file(s) to attach to message  [array]
      --title     title for the session (uses truncated prompt if no value provided)  [string]
      --attach    attach to a running opencode server (e.g., http://localhost:4096)  [string]
  -p, --password  basic auth password (defaults to KILO_SERVER_PASSWORD)  [string]
      --dir       directory to run in, path on remote server if attaching  [string]
      --port      port for the local server (defaults to random port if no value provided)  [number]
      --variant   model variant (provider-specific reasoning effort, e.g., high, max, minimal)  [string]
      --thinking  show thinking blocks  [boolean] [default: false]

debugging and troubleshooting tools

Commands:
  kilo debug config        show resolved configuration
  kilo debug lsp           LSP debugging utilities
  kilo debug rg            ripgrep debugging utilities
  kilo debug file          file system debugging utilities
  kilo debug scrap         list all known projects
  kilo debug skill         list all available skills
  kilo debug snapshot      snapshot debugging utilities
  kilo debug agent <name>  show agent configuration details
  kilo debug paths         show global paths (data, config, cache, state)
  kilo debug wait          wait indefinitely (for debugging)

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

show resolved configuration

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

LSP debugging utilities

Commands:
  kilo debug lsp diagnostics <file>      get diagnostics for a file
  kilo debug lsp symbols <query>         search workspace symbols
  kilo debug lsp document-symbols <uri>  get symbols from a document

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

get diagnostics for a file

Positionals:
  file  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

search workspace symbols

Positionals:
  query  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

get symbols from a document

Positionals:
  uri  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

ripgrep debugging utilities

Commands:
  kilo debug rg tree              show file tree using ripgrep
  kilo debug rg files             list files using ripgrep
  kilo debug rg search <pattern>  search file contents using ripgrep

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

show file tree using ripgrep

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]
  --limit  [number]

list files using ripgrep

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]
  --query    Filter files by query  [string]
  --glob     Glob pattern to match files  [string]
  --limit    Limit number of results  [number]

search file contents using ripgrep

Positionals:
  pattern  Search pattern  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]
  --glob     File glob patterns  [array]
  --limit    Limit number of results  [number]

file system debugging utilities

Commands:
  kilo debug file read <path>     read file contents as JSON
  kilo debug file status          show file status information
  kilo debug file list <path>     list files in a directory
  kilo debug file search <query>  search files by query
  kilo debug file tree [dir]      show directory tree

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

read file contents as JSON

Positionals:
  path  File path to read  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

show file status information

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

list files in a directory

Positionals:
  path  File path to list  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

search files by query

Positionals:
  query  Search query  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

show directory tree

Positionals:
  dir  Directory to tree  [string] [default: "."]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

list all known projects

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

list all available skills

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

snapshot debugging utilities

Commands:
  kilo debug snapshot track         track current snapshot state
  kilo debug snapshot patch <hash>  show patch for a snapshot hash
  kilo debug snapshot diff <hash>   show diff for a snapshot hash

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

track current snapshot state

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

show patch for a snapshot hash

Positionals:
  hash  hash  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

show diff for a snapshot hash

Positionals:
  hash  hash  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

show agent configuration details

Positionals:
  name  Agent name  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]
  --tool     Tool id to execute  [string]
  --params   Tool params as JSON or a JS object literal  [string]

show global paths (data, config, cache, state)

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

wait indefinitely (for debugging)

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

manage AI providers and credentials

Commands:
  kilo auth list         list providers  [aliases: ls]
  kilo auth login [url]  log in to a provider
  kilo auth logout       log out from a configured provider

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

list providers

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

log in to a provider

Positionals:
  url  kilo auth provider  [string]

Options:
      --help      Show help  [boolean]
      --version   Show version number  [boolean]
  -p, --provider  provider id or name to log in to (skips provider selection)  [string]
  -m, --method    login method label (skips method selection)  [string]

log out from a configured provider

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

manage agents

Commands:
  kilo agent create  create a new agent
  kilo agent list    list all available agents

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

create a new agent

Options:
      --help         Show help  [boolean]
      --version      Show version number  [boolean]
      --path         directory path to generate the agent file  [string]
      --description  what the agent should do  [string]
      --mode         agent mode  [string] [choices: "all", "primary", "subagent"]
      --tools        comma-separated list of tools to enable (default: all). Available: "bash, read, write, edit, list, glob, grep, webfetch, task, todowrite"  [string]
  -m, --model        model to use in the format of provider/model  [string]

list all available agents

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

upgrade kilo to the latest or a specific version

Positionals:
  target  version to upgrade to, for ex '0.1.48' or 'v0.1.48'  [string]

Options:
      --help     Show help  [boolean]
      --version  Show version number  [boolean]
  -m, --method   installation method to use  [string] [choices: "curl", "npm", "pnpm", "bun", "brew", "choco", "scoop"]

uninstall kilo and remove all related files

Options:
      --help         Show help  [boolean]
      --version      Show version number  [boolean]
  -c, --keep-config  keep configuration files  [boolean] [default: false]
  -d, --keep-data    keep session data and snapshots  [boolean] [default: false]
      --dry-run      show what would be removed without removing  [boolean] [default: false]
  -f, --force        skip confirmation prompts  [boolean] [default: false]

starts a headless kilo server

Options:
  --help         Show help  [boolean]
  --version      Show version number  [boolean]
  --port         port to listen on  [number] [default: 0]
  --hostname     hostname to listen on  [string] [default: "127.0.0.1"]
  --mdns         enable mDNS service discovery (defaults hostname to 0.0.0.0)  [boolean] [default: false]
  --mdns-domain  custom domain name for mDNS service (default: kilo.local)  [string] [default: "kilo.local"]
  --cors         additional domains to allow for CORS  [array] [default: []]

list all available models

Positionals:
  provider  provider ID to filter models by  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]
  --verbose  use more verbose model output (includes metadata like costs)  [boolean]
  --refresh  refresh the models cache from models.dev  [boolean]

show token usage and cost statistics

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]
  --days     show stats for the last N days (default: all time)  [number]
  --tools    number of tools to show (default: all)  [number]
  --models   show model statistics (default: hidden). Pass a number to show top N, otherwise shows all
  --project  filter by project (default: all projects, empty string: current project)  [string]

export session data as JSON

Positionals:
  sessionID  session id to export  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

import session data from JSON file or URL

Positionals:
  file  path to JSON file or share URL  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

fetch and checkout a GitHub PR branch, then run kilo

Positionals:
  number  PR number to checkout  [number]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

manage sessions

Commands:
  kilo session list                list sessions
  kilo session delete <sessionID>  delete a session

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

list sessions

Options:
      --help       Show help  [boolean]
      --version    Show version number  [boolean]
  -n, --max-count  limit to N most recent sessions  [number]
      --format     output format  [string] [choices: "table", "json"] [default: "table"]
  -a, --all        list sessions from all projects  [boolean] [default: false]
  -s, --search     filter sessions by title  [string]

delete a session

Positionals:
  sessionID  session ID to delete  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

enable remote connection for real-time session relay

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

database tools

Commands:
  kilo db [query]     open an interactive sqlite3 shell or run a query  [default]
  kilo db path        print the database path
  kilo db migrate     migrate JSON data to SQLite (merges with existing data)

Positionals:
  query  SQL query to execute  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]
  --format   Output format  [string] [choices: "json", "tsv"] [default: "tsv"]

print the database path

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

migrate JSON data to SQLite (merges with existing data)

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

configuration tools

Commands:
  kilo config check  check configuration for warnings and errors

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

check configuration for warnings and errors

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]

install plugin and update config

Positionals:
  module  npm module name  [string]

Options:
      --help     Show help  [boolean]
      --version  Show version number  [boolean]
  -g, --global   install in global config  [boolean] [default: false]
  -f, --force    replace existing plugin version  [boolean] [default: false]

show full CLI reference

Positionals:
  command  command to show help for  [string]

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]
  --all      show help for all commands  [boolean] [default: false]
  --format   output format  [string] [choices: "md", "text"] [default: "md"]

generate shell completion script

Options:
  --help     Show help  [boolean]
  --version  Show version number  [boolean]