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

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

Examples

Start a director session with the default persona

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

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

Errors