# kilo-org/kilocode architecture

> Architecture diagram of the GitHub repository kilo-org/kilocode, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kilo-org/kilocode
- Repository: https://github.com/kilo-org/kilocode

## Overview

Kilo Code is an AI coding agent exposed through VS Code, JetBrains, and CLI interfaces. A typical task starts with a user request, uses an agent and selected model to inspect or change a project, and can run commands and self-check its work. The repository also includes autocomplete, code review, indexing, and cloud/gateway capabilities. The README documents the product workflow and capabilities; source excerpts are limited, so internal runtime connections not shown there are left unverified rather than inferred.

Main entry points: [`packages/core/src/session`](https://github.com/kilo-org/kilocode/tree/main/packages/core/src/session) (Session Runtime), [`packages/kilo-vscode`](https://github.com/kilo-org/kilocode/tree/main/packages/kilo-vscode) (VS Code), [`packages/core/src/tool`](https://github.com/kilo-org/kilocode/tree/main/packages/core/src/tool) (Agent Tools), [`packages/kilo-jetbrains`](https://github.com/kilo-org/kilocode/tree/main/packages/kilo-jetbrains) (JetBrains)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_vscode["VS Code"]
  node_jetbrains["JetBrains"]
  node_cli["CLI / TUI<br/>[app.tsx]"]
end

subgraph group_agent["Agent Runtime"]
  node_session["Session Runtime"]
  node_agents["Agent Modes<br/>[agent.ts]"]
  node_models["Model Providers<br/>[provider.ts]"]
  node_tools["Agent Tools"]
end

subgraph group_project["Project Capabilities"]
  node_projectfiles["Project Filesystem<br/>[filesystem.ts]"]
  node_terminal["Terminal Control<br/>[pty.ts]"]
  node_autocomplete["Inline Autocomplete"]
  node_reviews["Code Reviews"]
  node_indexing["Code Indexing<br/>[manager.ts]"]
end

subgraph group_platform["Services"]
  node_gateway["Kilo Gateway<br/>[routes.ts]"]
  node_server["HTTP Server<br/>[routes.ts]"]
  node_sessionstore[("Session Storage<br/>[store.ts]")]
end

node_developer(("Developer"))

node_developer -->|"uses"| node_vscode
node_developer -->|"uses"| node_jetbrains
node_developer -->|"uses"| node_cli
node_vscode -.->|"starts tasks"| node_session
node_jetbrains -.->|"starts tasks"| node_session
node_cli -.->|"starts tasks"| node_session
node_session -.->|"selects agent"| node_agents
node_session -.->|"requests inference"| node_models
node_session -.->|"dispatches tools"| node_tools
node_tools -.->|"changes files"| node_projectfiles
node_tools -.->|"runs commands"| node_terminal
node_vscode -->|"offers suggestions"| node_autocomplete
node_developer -->|"requests reviews"| node_reviews
node_session -.->|"uses context"| node_indexing
node_session -.->|"stores history"| node_sessionstore
node_session -.->|"serves requests"| node_server
node_session -.->|"uses cloud features"| node_gateway

click node_vscode "https://github.com/kilo-org/kilocode/tree/main/packages/kilo-vscode"
click node_jetbrains "https://github.com/kilo-org/kilocode/tree/main/packages/kilo-jetbrains"
click node_cli "https://github.com/kilo-org/kilocode/blob/main/packages/tui/src/app.tsx"
click node_session "https://github.com/kilo-org/kilocode/tree/main/packages/core/src/session"
click node_agents "https://github.com/kilo-org/kilocode/blob/main/packages/core/src/agent.ts"
click node_models "https://github.com/kilo-org/kilocode/blob/main/packages/core/src/plugin/provider.ts"
click node_tools "https://github.com/kilo-org/kilocode/tree/main/packages/core/src/tool"
click node_projectfiles "https://github.com/kilo-org/kilocode/blob/main/packages/core/src/filesystem.ts"
click node_terminal "https://github.com/kilo-org/kilocode/blob/main/packages/core/src/pty.ts"
click node_autocomplete "https://github.com/kilo-org/kilocode/blob/main/packages/kilo-vscode/src/services/autocomplete/continuedev/core/autocomplete/context/ContextRetrievalService.ts"
click node_reviews "https://github.com/kilo-org/kilocode/blob/main/packages/kilo-vscode/webview-ui/diff-viewer/review-controller.ts"
click node_indexing "https://github.com/kilo-org/kilocode/blob/main/packages/kilo-indexing/src/indexing/manager.ts"
click node_gateway "https://github.com/kilo-org/kilocode/blob/main/packages/kilo-gateway/src/server/routes.ts"
click node_server "https://github.com/kilo-org/kilocode/blob/main/packages/server/src/routes.ts"
click node_sessionstore "https://github.com/kilo-org/kilocode/blob/main/packages/core/src/session/store.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_vscode,node_jetbrains,node_cli toneBlue
class node_session,node_agents,node_models,node_tools toneAmber
class node_projectfiles,node_terminal,node_autocomplete,node_reviews,node_indexing toneMint
class node_gateway,node_server,node_sessionstore toneRose
class node_developer toneIndigo
```

## Components

### User Interfaces

- [VS Code](https://github.com/kilo-org/kilocode/tree/main/packages/kilo-vscode): `packages/kilo-vscode`
- [JetBrains](https://github.com/kilo-org/kilocode/tree/main/packages/kilo-jetbrains): `packages/kilo-jetbrains`
- [CLI / TUI](https://github.com/kilo-org/kilocode/blob/main/packages/tui/src/app.tsx): `packages/tui/src/app.tsx`

### Agent Runtime

- [Session Runtime](https://github.com/kilo-org/kilocode/tree/main/packages/core/src/session): `packages/core/src/session`
- [Agent Modes](https://github.com/kilo-org/kilocode/blob/main/packages/core/src/agent.ts): `packages/core/src/agent.ts`
- [Model Providers](https://github.com/kilo-org/kilocode/blob/main/packages/core/src/plugin/provider.ts): `packages/core/src/plugin/provider.ts`
- [Agent Tools](https://github.com/kilo-org/kilocode/tree/main/packages/core/src/tool): `packages/core/src/tool`

### Project Capabilities

- [Project Filesystem](https://github.com/kilo-org/kilocode/blob/main/packages/core/src/filesystem.ts): `packages/core/src/filesystem.ts`
- [Terminal Control](https://github.com/kilo-org/kilocode/blob/main/packages/core/src/pty.ts): `packages/core/src/pty.ts`
- [Inline Autocomplete](https://github.com/kilo-org/kilocode/blob/main/packages/kilo-vscode/src/services/autocomplete/continuedev/core/autocomplete/context/ContextRetrievalService.ts): `packages/kilo-vscode/src/services/autocomplete/continuedev/core/autocomplete/context/ContextRetrievalService.ts`
- [Code Reviews](https://github.com/kilo-org/kilocode/blob/main/packages/kilo-vscode/webview-ui/diff-viewer/review-controller.ts): `packages/kilo-vscode/webview-ui/diff-viewer/review-controller.ts`
- [Code Indexing](https://github.com/kilo-org/kilocode/blob/main/packages/kilo-indexing/src/indexing/manager.ts): `packages/kilo-indexing/src/indexing/manager.ts`

### Services

- [Kilo Gateway](https://github.com/kilo-org/kilocode/blob/main/packages/kilo-gateway/src/server/routes.ts): `packages/kilo-gateway/src/server/routes.ts`
- [HTTP Server](https://github.com/kilo-org/kilocode/blob/main/packages/server/src/routes.ts): `packages/server/src/routes.ts`
- [Session Storage](https://github.com/kilo-org/kilocode/blob/main/packages/core/src/session/store.ts): `packages/core/src/session/store.ts`

### Other components

- **Developer**

## Connections

- Developer → VS Code: uses (evidence: `README.md`)
- Developer → JetBrains: uses (evidence: `README.md`)
- Developer → CLI / TUI: uses (evidence: `README.md`)
- VS Code → Session Runtime: starts tasks
- JetBrains → Session Runtime: starts tasks
- CLI / TUI → Session Runtime: starts tasks
- Session Runtime → Agent Modes: selects agent
- Session Runtime → Model Providers: requests inference
- Session Runtime → Agent Tools: dispatches tools
- Agent Tools → Project Filesystem: changes files
- Agent Tools → Terminal Control: runs commands
- VS Code → Inline Autocomplete: offers suggestions (evidence: `README.md`)
- Developer → Code Reviews: requests reviews (evidence: `README.md`)
- Session Runtime → Code Indexing: uses context
- Session Runtime → Session Storage: stores history
- Session Runtime → HTTP Server: serves requests
- Session Runtime → Kilo Gateway: uses cloud features
