0
Fork 0
mirror of https://github.com/zeronsh/comet.git synced 2026-11-16 18:57:19 +00:00
comet/docs/screenshots/background-processes
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>
History 2026-10-29 15:26:00 -07:00
..
collapsed.png Background processes: see, read and stop what an agent left running (#1092) 2026-10-29 15:26:00 -07:00
expanded.png Background processes: see, read and stop what an agent left running (#1092) 2026-10-29 15:26:00 -07:00
output.png Background processes: see, read and stop what an agent left running (#1092) 2026-10-29 15:26:00 -07:00
README.md Background processes: see, read and stop what an agent left running (#1092) 2026-10-29 15:26:00 -07:00
stopped.png Background processes: see, read and stop what an agent left running (#1092) 2026-10-29 15:26:00 -07:00
stopping.png Background processes: see, read and stop what an agent left running (#1092) 2026-10-29 15:26:00 -07:00

Background process screenshots

Real Linux desktop application captures taken on 2026-10-28 from this branch, built with cargo build -p zeron. The application ran in Xvfb (Mesa lavapipe software Vulkan) at a 1280 × 800 window size against a separate local engine with temporary data directories, one empty demo project, and the mock harness with ZERON_MOCK_BACKGROUND=1 (its turn leaves three scripted processes running, which print output and honor Stop). Input was driven with xdotool; images were captured from the X display with ImageMagick import. They are unedited screenshots, not mockups, and are not bundled into the application.

  • collapsed.png: after the turn, the composer's Background tray says three processes are running and lists their commands. Collapsed is the default.
  • expanded.png: one row per process: the command, the agent's description of it, how long it has run, and its Stop button.
  • output.png: clicking a row opens the tail of that process's output, here the doc-test watcher's last run.
  • stopping.png: Stop on the log watcher: the row dims and reads Stopping… until the host reports it gone.
  • stopped.png: the process has left the list (the count reads 2); the other two keep running.