Kilo Code Documentation

repository·main·Indexed 31 days ago

https://github.com/kilo-org/kilocode

An AI-powered development platform providing autonomous agents (Architect, Coder, Debugger) to assist with software engineering tasks. Includes a GitHub Action for triggering code implementations, debugging, and investigations via comments, as well as specialized CI container images and the @kilocode/kilo-gateway for AI provider integration.

Tokens
216.8K
Snippets
334
Records
1.2K
Agent score
99%

What's inside kilocode

  1. Overview of Local Model Providers

    main

    Kilo Code allows you to run language models locally on your machine, providing privacy, offline access, and cost savings.

    Supported providers include:

    • Ollama: Open-source tool supporting a wide range of models.
    • LM Studio: Desktop application that provides a local server emulating the OpenAI API.
    • Atomic Chat: Open-source local AI with TurboQuant-optimized inference and an OpenAI-compatible API on port 1337. Kilo Code can automatically discover models if you use the provider.atomic-chat setting, atomicChat.autoDetect, or a model name prefixed with atomic-chat/....
  2. Overview of Kilo Code Agents

    main

    Kilo Code provides specialized agents that you can switch between depending on your task:

    • Code: The default agent. Implements and edits code using natural language.
    • Plan: Designs architecture and writes implementation plans before writing code.
    • Ask: Answers questions about your codebase without modifying files.
    • Debug: Troubleshoots and tracks down issues.
    • Review: Reviews changes to identify performance, security, style, and test coverage issues.

    You can also create your own custom agents.

  3. Overview of Kilo Code AI Coding Capabilities

    main

    Kilo Code is an AI pair programmer designed to assist with code generation, refactoring, debugging, and shipping software. It operates across multiple interfaces including IDEs, terminals, and browsers, providing AI that understands your specific codebase and context.

    Core Capabilities

    • Code Generation & Refactoring: Use Autocomplete for inline suggestions and Code Actions for AI-powered refactoring and fixes.
    • Task Management: Utilize Task & Todo Lists to decompose complex engineering tasks and Checkpoints to save or restore specific working states.
    • Advanced Automation: Leverage Browser Use to automate web interactions and Git Commit Generation to create meaningful commit messages.
    • Prompt Optimization: Use Enhance Prompt to automatically improve the quality of your instructions to the AI.
  4. Overview of Kilo Code Agents

    main

    Kilo Code provides specialized agents that can be switched depending on the task. You can also create your own custom agents.

    • Code: Implements and edits code from natural language.
    • Plan: Designs architecture and writes implementation plans before writing code.
    • Ask: Answers questions about the codebase without modifying files.
    • Debug: Resolves and tracks issues.
    • Review: Reviews changes to find issues in performance, security, style, and test coverage.
  5. Overview of Kilo Code VS Code features

    main

    The Kilo Code VS Code extension integrates chat, agents, and automation directly into the editor using a SolidJS-based UI.

    Key capabilities include:

    • Portable Configuration: Uses kilo.jsonc for settings instead of standard VS Code settings.
    • Agents & Subagents: Customizable agents via .kilo/agents/*.md and specialized sub-agents for the task tool.
    • Agent Manager: Includes a diff panel, multi-model comparison, PR import, and code review annotations.
    • Autocomplete: FIM-based (Fill-In-the-Middle) autocomplete using Codestral with status bar cost tracking.
    • Workflows & Skills: Repeatable prompt templates via .md files and specialized domain knowledge via SKILL.md files.
    • Session Management: Ability to "Open in Tab" for chat, export transcripts as Markdown, and use a Sub-Agent Viewer to monitor child agent sessions.
    • Permissions: Granular, per-tool permission rules using glob patterns.
  6. Overview of Kilo Code Agents

    main

    Kilo Code provides specialized agents that you can switch between depending on the task:

    • Code: Implements and edits code from natural language.
    • Plan: Designs architecture and writes implementation plans before coding.
    • Ask: Answers questions about the codebase without modifying files.
    • Debug: Diagnoses and tracks down issues.
    • Review: Reviews changes to identify performance, security, style, and test coverage issues.
  7. Overview of Kilo Code Agents

    main

    Kilo provides specialized agents that can be switched depending on the task. You can also build custom agents.

    • Code: The standard agent. Implements and edits code using natural language.
    • Plan: Designs architecture and writes implementation plans before writing code.
    • Ask: Answers questions about your codebase without modifying files.
    • Debug: Troubleshoots and tracks down issues.
    • Review: Reviews changes to find issues with performance, security, style, and test coverage.
  8. Overview of Kilo Code Agents

    main

    Kilo Code provides specialized agents that you can switch between depending on your task. You can also create custom agents.

    • Code: The default agent. Executes and modifies code based on natural language instructions.
    • Plan: Designs architecture and writes implementation plans before writing any code.
    • Ask: Answers questions about your codebase without modifying files.
    • Debug: Explores and traces issues.
    • Review: Reviews your changes to detect performance, security, style, and test coverage issues.
  9. Introduction to Kilo Code capabilities and environments

    main

    Kilo Code is an open-source agentic engineering platform that allows you to generate, refactor, debug, and automate software engineering tasks. It is designed to work across multiple environments with synchronized sessions.

    Supported Environments

    • IDEs: VS Code, JetBrains, Cursor, Windsurf, and other VS Code forks.
    • CLI: Terminal-based access for scripting and automation.
    • Mobile: iOS and Android apps.
    • Communication: Slack integration for workspace chatting.
    • Web: Browser access (coming soon).

    Core Capabilities

    • Code with AI: Generate and refactor code using specialized modes (Code, Architect, Debug, Ask) or custom modes. Includes Autocomplete for inline suggestions.
    • Collaborate: Share sessions and manage team settings/AI adoption.
    • Automate: Set up AI-powered code reviews, triage agents, and auto-fixers that open PRs based on issues.
    • Deploy & Secure: Build/deploy apps, run security scans, and manage issues via AI.
  10. Overview of Kilo Code Agents

    main

    Kilo includes specialized agents that can be switched depending on the task. You can also create custom agents.

    • Code: The default agent. Implements and edits code from natural language.
    • Plan: Designs architecture and creates implementation plans before writing code.
    • Ask: Answers questions about the codebase without modifying files.
    • Debug: Performs troubleshooting and issue tracking.
    • Review: Reviews changes to detect performance, security, style, and test coverage issues.
  11. Overview of Model Context Protocol (MCP)

    main

    The Model Context Protocol (MCP) is a standard used to extend Kilo Code's capabilities by connecting it to external tools and services. MCP servers allow Kilo Code to interact with resources beyond its built-in features, such as databases, custom APIs, and specialized local or remote functionality.

    Key concepts include:

    • Client-Server Architecture: Kilo Code acts as the client, interacting with MCP servers that provide tools and resources.
    • Transports: Servers can communicate via STDIO (typically for local processes) or SSE (Server-Sent Events, typically for remote services).
    • Permissions: MCP tools are managed using the same allow / ask / deny permission system used for built-in tools, allowing you to control whether tools are auto-approved, prompt for user permission, or are blocked.
  12. Overview of Gastown by Kilo

    main

    Gastown by Kilo is an autonomous agent orchestration platform designed to manage teams of specialized AI agents working on your codebase. It is built on the Gastown open protocol and coordinates multiple agents to ship features, fix bugs, and maintain projects with minimal human intervention.

    Specialized Agent Roles

    AgentRoleDescription
    PolecatsCodingWrite code, run tests, and push branches. Multiple Polecats can work simultaneously on different tasks.
    RefineryCode ReviewReviews Polecat output, runs quality checks, and merges approved work.
    MayorCoordinationYour conversational interface. Plans work, answers questions, triages issues, and maintains town state.

    Core Workflow

    1. Create a town: Connect a GitHub repository to a new town to provision a dedicated environment.
    2. Sling work: Describe tasks (bugs, features, refactors) as individual Beads or as a Convoy (a multi-step plan where tasks depend on each other).
    3. Agent Execution: The reconciler assigns work to available Polecats, who use individual git worktrees to write and push code.
    4. Review & Merge: Completed work flows to the Refinery for automated review and merging based on your configured strategy.
    5. Control: Monitor progress via the town dashboard and interact with the Mayor to adjust priorities or intervene.