[teamleaderleo]

Summary

Design for first-class background processes in acpmux: list, tail and kill the dev servers, watchers and long test runs an agent starts, and keep them running past the turn and past a closed chat. The NEXT GUI (op-next-launch) builds on the wire contract here.

ACP has nothing for this. Its client-side terminal/* methods are going away in v2, and no RFD or PR covers listing or killing processes, so it's an _acpmux/* extension that we'll offer upstream as an RFD once it works for us. The decision to stay on ACP rather than fork it is in cmuxterm-hq#2014.

Doc: cmux-tui/crates/acpmux/docs/background-processes.md. It covers:

• Process record: one per process, kept with the session.
• Sources: Claude Code's task events and output file; Codex's commandExecution items and thread/backgroundTerminals/*.
• Wire: _acpmux/process/{list,tail,watch,kill} and a process_update notification that replaces background_task_update.
• Lifetime: what happens at turn end, chat close, over budget, daemon restart and harness exit.
• Client contract for the GUI.
• Planned behavior tests.

Part of it is built: #20585 (lifted limits, running updates, the idle reaper fix) and #20724 (the registry for Claude Code's shells: process/list, process/kill, process_update). The doc marks what is built. Still to build: tail/watch, Codex, and the per-session resource valve, which comes back without process scanning in cx-v9s8g.

Testing

Docs only; nothing to run.

Changelog

none

Proof

Docs only.

🤖 Generated with Claude Code

---

^{Need help on this PR? Tag @codesmith-bot with what you need.}

---

Summary by cubic

Adds a design doc for first-class background processes in acpmux: listing, tailing, and killing the dev servers, watchers, and long test runs an agent starts, and keeping them running past the turn and past a closed chat.

• Introduces a per-process record kept with the session, fed by Claude Code's task events and Codex's background terminals.
• Defines the _acpmux/process/{list,tail,watch,kill} wire contract and a process_update notification replacing the non-spec background_task_update; list, kill, and process_update are built, the rest is pending.
• Covers lifetime rules at turn end, chat close, harness exit, and daemon restart; over-budget killing is deferred to cx-v9s8g without ps//proc scans, and the client contract for the NEXT GUI is included.
• Regenerates schemas/defaults/cmux-next.json, which adds setting.freeModel.enabled; unrelated to the doc.

Docs only; nothing to run.

^{Written for commit 9440442. Summary will update on new commits.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

• Configuration used: Repository: manaflow-ai/cmux/.coderabbit.yaml
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: a002384d-43a7-47de-8a5f-8587c5f46f2c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[teamleaderleo]

Bead cx-ftyc1 created for this PR by the cmux coordinator.

[cursor]

Bugbot needs on-demand usage enabled

Bugbot uses usage-based billing for this team and requires on-demand usage to be enabled.

A team admin can enable on-demand usage in the Cursor dashboard.

[blacksmith-sh]

Found 1 test failure on Blacksmith runners:

Failure

Test	View Logs
the repository has capability texts that say update/ the repository has capability texts that say update	View Logs

^{Need help on this PR? Tag @codesmith-bot with what you need.}