From ef64b4b329dc5b71883e040c47b54c5c9714aee4 Mon Sep 17 00:00:00 2001 From: marius-kilocode Date: Mon, 24 Aug 2026 17:59:04 +0200 Subject: [PATCH] docs(vscode): document background agent status strip --- .../code-with-ai/platforms/vscode/index.md | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/packages/kilo-docs/pages/code-with-ai/platforms/vscode/index.md b/packages/kilo-docs/pages/code-with-ai/platforms/vscode/index.md index 3f4b6f5b3435..e264507d77a0 100644 --- a/packages/kilo-docs/pages/code-with-ai/platforms/vscode/index.md +++ b/packages/kilo-docs/pages/code-with-ai/platforms/vscode/index.md @@ -35,6 +35,28 @@ Key features include: - **Sub-Agent Viewer** — Read-only panels for viewing child agent sessions - **Legacy Migration** — Automatic migration wizard for VSCode extension settings +## Background agents + +When Kilo starts an agent in the background, a collapsible status strip appears in the chat header. The strip stays visible while the transcript scrolls, so you can check background work without searching the conversation. Click the strip to expand it and see each agent. + +Each agent shows one of these states: + +| State | Meaning | +|---|---| +| **Running** | The agent is still working. | +| **Done** | The agent completed successfully. | +| **Cancelled** | The agent was stopped before it completed. | +| **Error** | The agent stopped because it encountered an error. | + +An agent can also show **Needs input** when it is waiting for a permission decision or an answer to a question. Open the agent row to inspect its read-only transcript and handle the request in the child-agent view. In the sidebar and Kilo tab, the transcript opens in a read-only editor tab. In Agent Manager, it opens in the right-hand inspector. + +Use these controls in the expanded strip: + +- **Stop** cancels a running agent and its child session. +- **Dismiss** hides one finished agent from the strip. It does not delete the transcript or the agent record. +- **Clear finished** hides all agents that are no longer running. +- **Continue in background** appears when a foreground subagent is running. It detaches that work so the parent session can continue while the subagent runs in the background. + ## Shared Settings Settings apply across extension surfaces, including the sidebar and Agent Manager. The standalone CLI uses the same `~/.config/kilo/kilo.jsonc` (global) and `./kilo.jsonc` (project) files when used directly.