0
Fork 0
mirror of https://github.com/zeronsh/comet.git synced 2026-11-16 18:57:19 +00:00
comet/docs/background-processes.md
zeronsh[bot] 6aa4d5af31
Background processes: see, read and stop what an agent left running (#1092)
Agents start dev servers, watchers and log tails in the background and move
on. The runtime already counted them (to keep the idle reaper off), but
nothing showed them. Now each driver publishes its agent's live set on
TurnControl, the engine mirrors it on the chat's session row, and the
composer shows it in a Background tray above the checklist: what runs, for
how long, the tail of its output, and a Stop per process.

- Claude: the background_tasks_changed roster (local_bash), joined to the
  spawning Bash/Monitor command via task_started, output from the task's
  output file, stopped with the stop_task control request.
- Codex: commandExecution items still open after their turn, without the
  login-shell wrapper; output from outputDelta (no longer opted out), stopped
  with thread/backgroundTerminals/terminate.
- StopBackgroundTask / ReadBackgroundTaskOutput, relay-forwardable, behind
  the background-tasks-v1 capability.
- Mock: ZERON_MOCK_BACKGROUND=1.

Co-authored-by: Wing <44917547+wingleeio@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: zeronsh[bot] <346184242+zeronsh[bot]@users.noreply.github.com>
2026-10-29 15:26:00 -07:00

103 lines
5.7 KiB