add Kilo legacy VSCode extension agent support (#1209)

This PR adds support for the original (legacy) Kilo Code agent VSCode extension. 

This agent parser covers the pre-OpenCode legacy extension (the RooCode-derived codebase). Kilo released a rebuilt VS Code extension on an OpenCode core in March 2026, which is already supported by the main `kilo` parser in AgentsView.

Co-authored-by: Stephen Cross <scross01@users.noreply.github.com>

Author: scross01

README.md

@@ -334,6 +334,7 @@ thread JSON files.
 | Hermes Agent          | `~/.hermes/sessions/`                                                                                                                                                   |
 | iFlow                 | `~/.iflow/projects/`                                                                                                                                                    |
 | Kilo                  | `~/.local/share/kilo/`                                                                                                                                                  |
+| Kilo (legacy)         | `~/Library/Application Support/Code/User/globalStorage/kilocode.kilo-code/` (macOS), `~/.config/Code/User/globalStorage/kilocode.kilo-code/` (Linux)                     |
 | Kimi                  | `~/.kimi/sessions/`                                                                                                                                                     |
 | Kiro CLI              | `~/.kiro/sessions/cli/`, `~/.local/share/kiro-cli/`                                                                                                                     |
 | Kiro IDE              | `~/Library/Application Support/Kiro/` (macOS)                                                                                                                           |
@@ -464,6 +465,13 @@ Sidecars stay on your machine. agentsview makes no outbound request to produce
 or read them, and treats sidecars as untrusted structured input -- see
 [SECURITY.md](SECURITY.md) for the trust model.
 
+### Kilo vs Kilo (legacy).
+
+*Kilo* is the OpenCode-based CLI/editor core (`~/.local/share/kilo/kilo.db`); 
+it covers both the Kilo CLI and the rebuilt Kilo Code VS Code extension (after 
+March 2026), which shares that same database. *Kilo (legacy)* is the legacy RooCode-derived
+VS Code extension that wrote per-task JSON under `kilocode.kilo-code/tasks/`.
+
 ## PostgreSQL Sync
 
 Push session data to a shared PostgreSQL instance for team dashboards:

docs/configuration.md

@@ -256,6 +256,7 @@ can still be parsed.
 | Kimi                  | `~/.kimi/sessions/` and `~/.kimi-code/sessions/`                                 | JSONL per session                                                                                                               |
 | Kiro CLI              | `~/.kiro/sessions/cli/` and `~/.local/share/kiro-cli/`                           | JSONL per session and SQLite database                                                                                           |
 | Kiro IDE              | (platform-specific, see below)                                                   | JSON / chat files                                                                                                               |
+| Kilo (legacy)         | (platform-specific, see below)                                                   | `tasks/<uuid>/{task_metadata.json,ui_messages.json,api_conversation_history.json}`                                              |
 | MiMoCode              | `~/.local/share/mimocode/`                                                       | SQLite DB or `storage/` JSON files                                                                                              |
 | Mistral Vibe          | `~/.vibe/logs/session/`                                                          | Per-session `messages.jsonl` plus `meta.json`                                                                                   |
 | OhMyPi                | `~/.omp/agent/sessions/`                                                         | JSONL per session                                                                                                               |
@@ -461,6 +462,35 @@ RooCode was shut down on May 15, 2026. ZooCode (Zoo-CodeInc.zoo-cline) is the
 active community fork and will be supported separately. Set `ROOCODE_DIR` or
 `roocode_dirs` if your VSCode globalStorage directory is elsewhere.
 
+**Kilo (legacy) default directories** vary by platform, all rooted at the
+canonical lowercase `kilocode.kilo-code` global storage directory that VSCode
+writes on disk:
+
+- **macOS:** `~/Library/Application Support/Code/User/globalStorage/kilocode.kilo-code/`
+- **Linux:** `~/.config/Code/User/globalStorage/kilocode.kilo-code/`
+- **Windows:** `%APPDATA%/Code/User/globalStorage/kilocode.kilo-code/`
+
+Each `<root>/tasks/<uuid>/` task directory carries three JSON files:
+`task_metadata.json` (only stores `files_in_context`), the Claude-shaped
+`api_conversation_history.json`, and the Cline-shaped `ui_messages.json`.
+AgentsView folds the latter two into a composite fingerprint with
+`task_metadata.json` as the source anchor so changes to any of the three trigger
+a reparse. Sessions are parsed through RooCode-descended Cline message handling
+(tool-call and result pairing, reasoning pipeline, compact boundaries, error
+linking). Set `KILO_LEGACY_DIR` or `kilo_legacy_dirs` when the legacy extension
+stores its data outside the standard locations.
+
+**Kilo (legacy) vs Kilo.** These are two different agents. *Kilo* (the
+`kilo` agent) is the OpenCode-based core at `~/.local/share/kilo/`; it
+covers both the Kilo CLI and the rebuilt Kilo Code VS Code extension,
+which share that same `kilo.db`. *Kilo (legacy)* (the `kilo-legacy` agent)
+is the legacy RooCode-derived VS Code extension that wrote per-task JSON
+under `kilocode.kilo-code/tasks/` and stopped receiving new sessions after
+Kilo rebuilt the extension on OpenCode (public beta 2026-03-10, GA
+2026-04-02). The `kilo-legacy` agent is frozen at that legacy format and
+only archives older sessions; newer Kilo VS Code activity appears under
+`kilo`.
+
 **Antigravity CLI transcript sources:** Antigravity CLI has used both SQLite
 databases and AES-encrypted `.pb` files. AgentsView reads whichever source is
 richest, in this order:
@@ -532,6 +562,7 @@ export KILO_DIR=~/custom/kilo
 export KIMI_DIR=~/custom/kimi
 export KIRO_SESSIONS_DIR=~/custom/kiro
 export KIRO_IDE_DIR=~/custom/kiro-ide
+export KILO_LEGACY_DIR=~/custom/kilo-legacy
 export MIMOCODE_DIR=~/custom/mimocode
 export VIBE_SESSIONS_DIR=~/custom/vibe/logs/session
 export OMP_DIR=~/custom/omp
@@ -580,8 +611,7 @@ The corresponding fields are `aider_dirs`, `amp_dirs`, `antigravity_dirs`,
 `cowork_dirs`, `devin_dirs`, `codex_sessions_dirs`, `commandcode_project_dirs`,
 `copilot_dirs`, `cortex_dirs`, `cursor_project_dirs`,
 `deepseek_tui_sessions_dirs`, `forge_dirs`, `gemini_dirs`, `gptme_dirs`,
-`grok_dirs`, `hermes_sessions_dirs`, `iflow_dirs`, `kilo_dirs`, `kimi_dirs`,
-`kiro_dirs`, `kiro_ide_dirs`, `mimocode_dirs`, `vibe_session_dirs`,
+`grok_dirs`, `hermes_sessions_dirs`, `iflow_dirs`, `kilo_dirs`, `kilo_legacy_dirs`, `kimi_dirs`, `kiro_dirs`, `kiro_ide_dirs`, `mimocode_dirs`, `vibe_session_dirs`,
 `omp_dirs`, `openclaw_dirs`, `opencode_dirs`, `openhands_dirs`, `pi_dirs`,
 `piebald_dirs`, `posit_assistant_dirs`, `positron_dirs`, `qclaw_dirs`,
 `qoder_project_dirs`, `qwen_project_dirs`, `qwenpaw_dirs`, `reasonix_dirs`, `roocode_dirs`,

docs/internal/session-format-sources.md

@@ -233,6 +233,31 @@ Grok section and remove the explicit registry exception in the coverage test.
   Kilo migrations mean the pinned current source must be compared with legacy
   fixtures when changing compatibility.
 
+## Kilo (legacy) (`kilo-legacy`)
+
+- **Format:** Pre-OpenCode Kilo VSCode extension (`kilocode.kilo-code`) task
+  directories under VSCode `globalStorage`. Each session holds
+  `task_metadata.json` (files-in-context only), the Claude-shaped
+  `api_conversation_history.json`, and the Cline-shaped `ui_messages.json`.
+- **Evidence:** `source`.
+- **Upstream:** Clone `https://github.com/Kilo-Org/kilocode.git` at
+  `938919ab72e3977d1512e0363417270e3337c7b1`. The pinned
+  [task persistence](https://github.com/Kilo-Org/kilocode/blob/938919ab72e3977d1512e0363417270e3337c7b1/src/core/task-persistence/TaskHistoryStore.ts)
+  and
+  [UI message reader](https://github.com/Kilo-Org/kilocode/blob/938919ab72e3977d1512e0363417270e3337c7b1/src/core/task-persistence/taskMessages.ts)
+  own the Cline-shaped transcript. The extension was superseded by the
+  OpenCode-based rebuild (public beta 2026-03-10, GA 2026-04-02); new sessions
+  stopped appearing around 2026-03-21.
+- **Usage and cost:** `ui_messages.json` carries per-request `api_req_started`
+  metadata with input, output, cache-read, and cache-write tokens, explicit USD
+  cost, and `usageMissing` flag. `task_metadata.json` does not carry the
+  RooCode-style ID/token/cost wiring; token and cost totals are derived from
+  the transcript itself.
+- **Agentsview:** `internal/parser/kilo_legacy.go` and
+  `internal/parser/kilo_legacy_provider.go`; the parser borrows RooCode's
+  Cline message handling (tool-call pairing, reasoning, compact boundaries,
+  error linking). New sessions stopped after the OpenCode migration.
+
 ## Roo Code (`roocode`)
 
 - **Format:** One task directory per session with `history_item.json` metadata

frontend/src/lib/utils/agents.test.ts

@@ -18,6 +18,8 @@ describe("KNOWN_AGENTS", () => {
       "devin",
       "gemini",
       "opencode",
+      "kilo",
+      "kilo-legacy",
       "openhands",
       "cursor",
       "amp",

frontend/src/lib/utils/agents.ts

@@ -12,6 +12,8 @@ export const KNOWN_AGENTS: readonly AgentMeta[] = [
   { name: "devin", color: "var(--accent-red)", label: "Devin" },
   { name: "gemini", color: "var(--accent-rose)" },
   { name: "opencode", color: "var(--accent-purple)" },
+  { name: "kilo", color: "var(--accent-purple)", label: "Kilo" },
+  { name: "kilo-legacy", color: "var(--accent-purple)", label: "Kilo (legacy)" },
   { name: "openhands", color: "var(--accent-teal)", label: "OpenHands" },
   { name: "cursor", color: "var(--accent-black)" },
   { name: "amp", color: "var(--accent-coral)", label: "Amp" },