Skip to content

CMUX runbooks: launch workers lean + socket needs no setup - #4

Merged
caseycapshaw merged 1 commit into
mainfrom
cmux-launch-lean-and-socket-clarity
Jul 9, 2026
Merged

CMUX runbooks: launch workers lean + socket needs no setup#4
caseycapshaw merged 1 commit into
mainfrom
cmux-launch-lean-and-socket-clarity

Conversation

@casey-capshaw-rbrk

Copy link
Copy Markdown
Contributor

Follow-up to #3 (merged). Two field-tested refinements to the CMUX runbooks, based on main.

What this adds

  1. Launch pane workers lean. claude --model <id> --strict-mcp-config --mcp-config '{"mcpServers":{}}' (if your agent CLI supports it) gives a worker few/no MCP servers. A large MCP fleet injects enough tool schema to crowd out a worker's context after a handful of file reads — the same bloat that can make an in-process subagent/Task tool unusable, which is why explicit pane workers are the reliable path. In both runbooks' launch steps + the meta/AGENTS.md § Optional extensions model note.
  2. Socket wording = routine, no setup. Reframed the cmux identify / socketControlMode lines so they read as a sanity-check, not a config step: the in-pane control socket works out of the box under the default cmuxOnly; config only matters to drive CMUX from outside a pane.

Scope

  • 3 files, +30/-10. No new files.
  • Fully generic / templated (owner: {{NAME}}, no instance-specific model names or paths). Grep gate clean; kit lint green.

🤖 Generated with Claude Code

Two refinements to the CMUX orchestration runbooks landed in #3:

- Launch pane workers lean (`--strict-mcp-config` + empty mcp-config) so a
  large MCP fleet's tool schemas don't crowd out a worker's context — the
  same bloat that can make an in-process subagent/Task tool unusable, which
  is why explicit pane workers are the reliable path. Documented in both
  runbooks + the AGENTS.md § Optional extensions model note.
- Reframe the control-socket wording as a routine, no-setup sanity check
  (the in-pane socket works out of the box under the default cmuxOnly);
  config only matters to drive CMUX from outside a pane.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
fleet injects enough tool schema to crowd out a worker's context after ~a handful
of file reads — the same bloat that can make an in-process subagent/Task tool
unusable, which is why explicit pane workers are the reliable path. Add back only
a server the leg truly needs.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "the leg truly needs" — should be "the task truly needs" (matches the parallel wording in Jobs/Delegate an initiative to a CMUX workspace.md: "Add back only a server the task truly needs.").

@claude

claude Bot commented Jul 9, 2026

Copy link
Copy Markdown

VERDICT: ISSUES

Reviewed the diff (Jobs/Delegate an initiative to a CMUX workspace.md, Jobs/Spawn subagent panes in a CMUX workspace.md, meta/AGENTS.md).

Privacy: clean. No real names, hosts, credentials, or instance-specific content — pure framework guidance (lean-launch MCP config advice, socket-setup clarification). owner: {{NAME}} placeholders remain untouched in both Jobs files.

Schema consistency: clean. No new Jobs added (so no re-indexing needed), no new wikilink targets, frontmatter untouched, index.md/root unaffected.

Doc coherence: one nit — left an inline comment. Jobs/Spawn subagent panes in a CMUX workspace.md line 62 says "Add back only a server the leg truly needs" where the parallel sentence in the Delegate job (and the rest of this doc's terminology) uses "task"/"leg" inconsistently; likely a copy-paste typo for "task."

Everything else — the "launch lean" MCP guidance and the socket-setup clarifications — reads consistently across both Jobs files and the meta/AGENTS.md summary.

@caseycapshaw
caseycapshaw merged commit e105e98 into main Jul 9, 2026
2 checks passed
@caseycapshaw
caseycapshaw deleted the cmux-launch-lean-and-socket-clarity branch July 13, 2026 19:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants