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

# Welcome to Murmur

> Murmur orchestrates flocks of autonomous AI coding agents — spawn them from the CLI, dashboard, or MCP so they ship pull requests on your behalf.

Murmur is a cloud platform for running autonomous AI coding agents. Connect your GitHub org, spawn agents that clone repos, write code, and open pull requests, all on managed infrastructure. A single interactive session can spawn, monitor, and coordinate sub-agents recursively.

## Get started

<CardGroup cols={2}>
  <Card title="Admin quickstart" icon="rocket" href="/admin-quickstart">
    Set up your team's Workspace.
  </Card>

  <Card title="Developer quickstart" icon="screwdriver-wrench" href="/quickstart">
    Install the CLI and join your team's Workspace.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Connect your GitHub org">
    Install the [Macroscope GitHub App](https://app.macroscope.com/) on your organization. This one-time setup creates your tenant and scopes all Murmur resources to your org.

    See [Admin Quickstart](/admin-quickstart).
  </Step>

  <Step title="Set up your credentials">
    Each developer runs `murmur setup` once. It encrypts your GitHub token, Claude API key, and SSH signing key into a profile that only agent VMs can decrypt.

    See [Developer Quickstart](/quickstart).
  </Step>

  <Step title="Spawn an agent">
    Spawn an agent from your dashboard, CLI, or coding agent (e.g. Claude). The agent boots on a managed VM and starts running immediately.

    See [Spawn Your First Agent](/spawn-your-first-agent).
  </Step>

  <Step title="Customize your Workspace">
    Run `murmur init` to customize your Workspace according to your needs. The wizard bakes a custom Image with your toolchain and links the repos your agents should clone onto every VM.

    See [Customize your Workspace](/customize-your-workspace).
  </Step>

  <Step title="Onboard your team">
    Share the Developer Quickstart with your team. Each developer runs `murmur setup` in the cloned repo to add their own encrypted credentials, and can immediately spawn agents into your shared Workspace.

    See [Developer Quickstart](/quickstart).
  </Step>
</Steps>

## Core capabilities

<CardGroup cols={3}>
  <Card title="Agents" icon="robot" href="/concepts/agents">
    Autonomous Claude Code sessions on managed VMs. Interactive or headless. Recursive spawning.
  </Card>

  <Card title="Flights" icon="paper-plane" href="/concepts/flights">
    Declarative Markdown documents defining DAGs of agent tasks with dependencies and fanout.
  </Card>

  <Card title="Events" icon="bolt" href="/concepts/events">
    Real-time delivery of PR comments, reviews, and CI results to running agents.
  </Card>
</CardGroup>

## Explore further

<CardGroup cols={3}>
  <Card title="Core concepts" icon="lightbulb" href="/concepts/overview">
    Agents, Workspaces, Pools, Flights, Events, and the rest of the model.
  </Card>

  <Card title="Dashboard" icon="chart-tree-map" href="/guides/dashboard">
    Real-time agent tree, session streaming, file browser, and pool monitoring.
  </Card>

  <Card title="CLI reference" icon="terminal" href="/cli/overview">
    Complete reference for every `murmur` command.
  </Card>

  <Card title="MCP server" icon="wrench" href="/mcp-server/overview">
    Tools your coding agent uses to spawn, monitor, and coordinate Murmur agents.
  </Card>

  <Card title="Security" icon="lock" href="/security/overview">
    Zero secrets on disk. KMS-encrypted profiles. Per-VM ephemeral keys. Tenant isolation.
  </Card>

  <Card title="Guides" icon="book-open" href="/guides/multi-agent-orchestration">
    How-to walkthroughs for orchestration, custom Images, customer placements, and more.
  </Card>
</CardGroup>