Skip to main content
Starts an interactive director session. Fetches a persona from the catalog, then launches Claude Code with the murmur MCP server connected — giving you a live coding session where you can spawn and coordinate agents through conversation. This replaces the manual incantation of launching Claude Code with the right flags and MCP configuration. One command, and you are in a director session.

​
Synopsis

murmur director [flags]

​
Prerequisites

The command checks three things before starting the session:
  1. claude is on your PATH (install with npm install -g @anthropic-ai/claude-code).
  2. The murmur MCP server is configured in Claude Code (run claude mcp add murmur -- murmur mcp if not).
  3. Claude Code is authenticated (run claude auth if not).
If any prerequisite is missing, the command exits with a message telling you exactly what to run.

Why murmur director passes --dangerously-load-development-channels

Under the hood, murmur director launches Claude Code with --dangerously-load-development-channels server:murmur. The flag opts the session into Claude Code’s channel transport, which Murmur uses to stream real-time events (PR comments, CI results, child lifecycle, follow-ups) from the control plane into your conversation as <channel> tags. Without it the director can’t receive event pushes, and the coordinator loop across multiple agents stops working.The dangerously- prefix is Claude Code’s wording for an opt-in developer feature, not a security warning specific to Murmur. The same flag is also used by murmur init and by every interactive agent VM that Murmur spawns, so all sessions can post to and receive from server:murmur.When Claude Code prompts you to confirm channels, say yes and opt in. Murmur can’t deliver event pushes without it.

​
Arguments

NameTypeRequiredDescription
--personastringnoPersona name from the catalog. Default: murmur-director.

​
Examples

​
Start a director session with the default persona

murmur director
Fetches the murmur-director persona, then opens an interactive Claude Code session with the murmur MCP server attached. You land in a conversational interface where you can give instructions, spawn agents, check status, and coordinate work.

​
Start a session with a custom persona

murmur director --persona code-reviewer
Fetches the code-reviewer persona from the catalog and starts the session with that persona’s prompt.

​
Errors

CodeMeaningWhat to do
claude not foundClaude Code is not installed or not on your PATH.Install it: npm install -g @anthropic-ai/claude-code.
murmur MCP server not configuredThe murmur MCP server is not registered with Claude Code.Run: claude mcp add murmur -- murmur mcp.
not configured — run: murmur setupmurmur setup has not been run in this project.Run murmur setup to configure your workspace.
NOT_FOUNDThe requested persona does not exist in the catalog.Check the persona name. Use the default (murmur-director) or verify your custom persona is published.
UNAUTHENTICATEDIdentity token is missing or expired.Run murmur auth or check your murmur.local.yaml configuration.