From b1755f91848b083533e675ba38750063862344d4 Mon Sep 17 00:00:00 2001 From: marius-kilocode Date: Wed, 19 Aug 2026 11:16:11 +0200 Subject: [PATCH] fix(cli): clarify background process waits --- .changeset/blocking-shell-waits.md | 5 +++++ packages/opencode/src/kilocode/tool/background-process.txt | 4 +++- 2 files changed, 8 insertions(+), 1 deletion(-) create mode 100644 .changeset/blocking-shell-waits.md diff --git a/.changeset/blocking-shell-waits.md b/.changeset/blocking-shell-waits.md new file mode 100644 index 00000000000..8f7829ee24b --- /dev/null +++ b/.changeset/blocking-shell-waits.md @@ -0,0 +1,5 @@ +--- +"@kilocode/cli": patch +--- + +Keep one-time waits in the blocking shell tool instead of tracking them as background processes. diff --git a/packages/opencode/src/kilocode/tool/background-process.txt b/packages/opencode/src/kilocode/tool/background-process.txt index 73eeb81634f..82e11c5db78 100644 --- a/packages/opencode/src/kilocode/tool/background-process.txt +++ b/packages/opencode/src/kilocode/tool/background-process.txt @@ -1,6 +1,8 @@ Run and manage long-running background processes. -Use this tool for development servers, file watchers, local services, and commands that are expected to keep running, such as `npm run dev`, `next dev`, `vite`, `bun --watch`, or test watchers. +Use this tool only for processes that must keep running independently after this tool call returns, such as development servers, file watchers, local services, and test watchers (`npm run dev`, `next dev`, `vite`, or `bun --watch`). + +This tool cannot wait: `start` returns immediately and never blocks your turn. Do not start `sleep`, timers, cooldowns, delays, or polling loops with this tool. To wait a fixed time before your next action, run the wait as a normal blocking shell command and set its `timeout` higher than the wait. Do not use the shell tool with `&`, `nohup`, `disown`, `setsid`, `Start-Process`, or similar backgrounding patterns. Processes started with this tool are tracked and shown in the CLI sidebar.