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.Documentation Index
Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
Use this file to discover all available pages before exploring further.
Synopsis
Prerequisites
The command checks three things before starting the session:claudeis on yourPATH(install withnpm install -g @anthropic-ai/claude-code).- The murmur MCP server is configured in Claude Code (run
claude mcp add murmur -- murmur mcpif not). - Claude Code is authenticated (run
claude authif not).
Arguments
Examples
Start a director session with the default persona
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
code-reviewer persona from the catalog and starts the session with that persona’s prompt.
Errors
| Code | Meaning | What to do |
|---|---|---|
claude not found | Claude Code is not installed or not on your PATH. | Install it: npm install -g @anthropic-ai/claude-code. |
murmur MCP server not configured | The murmur MCP server is not registered with Claude Code. | Run: claude mcp add murmur -- murmur mcp. |
not configured — run: murmur setup | murmur setup has not been run in this project. | Run murmur setup to configure your workspace. |
NOT_FOUND | The requested persona does not exist in the catalog. | Check the persona name. Use the default (murmur-director) or verify your custom persona is published. |
UNAUTHENTICATED | Identity token is missing or expired. | Run murmur auth or check your murmur.local.yaml configuration. |
Related
- Director, concept overview of what a director is and the behavioral contract it follows
- Agent Personas, what personas are and how they shape agent behavior
- Catalog, where personas and other resources live
- Agents, concept overview
murmur status, check agent status during a director session- Multi-agent orchestration, guide to coordinating agents as a director