CMUX runbooks: launch workers lean + socket needs no setup - #4
Conversation
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. |
There was a problem hiding this comment.
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.").
|
VERDICT: ISSUES Reviewed the diff ( Privacy: clean. No real names, hosts, credentials, or instance-specific content — pure framework guidance (lean-launch MCP config advice, socket-setup clarification). Schema consistency: clean. No new Jobs added (so no re-indexing needed), no new wikilink targets, frontmatter untouched, Doc coherence: one nit — left an inline comment. Everything else — the "launch lean" MCP guidance and the socket-setup clarifications — reads consistently across both Jobs files and the |
Follow-up to #3 (merged). Two field-tested refinements to the CMUX runbooks, based on
main.What this adds
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 + themeta/AGENTS.md§ Optional extensions model note.cmux identify/socketControlModelines so they read as a sanity-check, not a config step: the in-pane control socket works out of the box under the defaultcmuxOnly; config only matters to drive CMUX from outside a pane.Scope
owner: {{NAME}}, no instance-specific model names or paths). Grep gate clean; kit lint green.🤖 Generated with Claude Code