> ## 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.

# murmur director

> Start an interactive Murmur director session — a local Claude conversation wired to the MCP server with a persona loaded from the catalog.

Starts an interactive director session. Fetches a [persona](/concepts/agent-personas) from the [catalog](/catalog/overview), then launches Claude Code with the murmur MCP server connected — giving you a live coding session where you can [spawn](/cli/spawn) and coordinate [agents](/concepts/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

```bash theme={null}
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.

<Card title="Why murmur director passes --dangerously-load-development-channels" icon="lightbulb-exclamation-on">
  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](/concepts/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`](/cli/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.
</Card>

## Arguments

| Name        | Type   | Required | Description                                                                                                 |
| ----------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------- |
| `--persona` | string | no       | [Persona](/concepts/agent-personas) name from the [catalog](/catalog/overview). Default: `murmur-director`. |

## Examples

### Start a director session with the default persona

```bash theme={null}
murmur director
```

Fetches the `murmur-director` [persona](/concepts/agent-personas), 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](/cli/spawn) [agents](/concepts/agents), check [status](/cli/status), and coordinate work.

### Start a session with a custom persona

```bash theme={null}
murmur director --persona code-reviewer
```

Fetches the `code-reviewer` [persona](/concepts/agent-personas) from the [catalog](/catalog/overview) 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`](/cli/setup) to configure your [workspace](/concepts/workspaces).                   |
| `NOT_FOUND`                          | The requested [persona](/concepts/agent-personas) does not exist in the [catalog](/catalog/overview). | 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](/concepts/director), concept overview of what a director is and the behavioral contract it follows
* [Agent Personas](/concepts/agent-personas), what personas are and how they shape agent behavior
* [Catalog](/catalog/overview), where personas and other resources live
* [Agents](/concepts/agents), concept overview
* [`murmur status`](/cli/status), check agent status during a director session
* [Multi-agent orchestration](/guides/multi-agent-orchestration), guide to coordinating agents as a director