# Murmur

## Docs

- [Admin Quickstart](https://docs.murmur.dev/admin-quickstart.md): Murmur setup happens in two stages: an admin initially configures the team workspace once, then developers can set up Murmur locally.
- [Configuration & CLI Reference](https://docs.murmur.dev/api/configuration-reference.md): End-to-end reference for provisioning and operating Murmur from the CLI. Every catalog resource, every command, every flag, with opinionated guidance on what a well-configured workspace looks like. Designed primarily for AI agents (Claude Code, Codex, etc.) operating on a user's behalf.
- [API Reference](https://docs.murmur.dev/api/overview.md): The MurmurService gRPC API — 80+ RPCs for agent lifecycle, streaming, catalog, pool management, and more.
- [Agent & Identity Resources](https://docs.murmur.dev/catalog/agent-resources.md): Catalog resources for agents, personas, flights, secrets, users, roles, and authorization.
- [Infrastructure Resources](https://docs.murmur.dev/catalog/infrastructure-resources.md): Catalog resources for compute infrastructure — workspaces, placements, environments, pool config, machine types, images, recipes, and repo config.
- [Catalog Resources](https://docs.murmur.dev/catalog/overview.md): The catalog is Murmur's resource registry — every configurable entity is a versioned, audited catalog resource.
- [Agent Management](https://docs.murmur.dev/cli/agent-management.md): Commands for monitoring, controlling, and interacting with running agents.
- [Catalog Operations](https://docs.murmur.dev/cli/catalog-operations.md): CRUD commands for managing catalog resources — workspaces, environments, placements, recipes, and more.
- [SSH & Port Forwarding](https://docs.murmur.dev/cli/connectivity.md): Connect to agent VMs via SSH and tunnel to local ports.
- [CLI Overview](https://docs.murmur.dev/cli/overview.md): The murmur CLI — your primary interface for spawning agents, managing pools, and operating the platform.
- [Pool Management](https://docs.murmur.dev/cli/pool-management.md): Monitor and configure the warm VM pool for your tenant.
- [Secrets Management](https://docs.murmur.dev/cli/secrets.md): Manage KMS-encrypted tenant and developer secrets from the CLI.
- [Setup & Authentication](https://docs.murmur.dev/cli/setup-and-auth.md): Developer onboarding commands — credential encryption, repo setup, and authentication.
- [murmur spawn](https://docs.murmur.dev/cli/spawn.md): Spawn an autonomous or interactive agent on a remote VM.
- [Task Checklists](https://docs.murmur.dev/cli/tasks.md): Create and manage structured task checklists for agents.
- [Agents](https://docs.murmur.dev/concepts/agents.md): How autonomous coding agents work — lifecycle, session modes, recursive spawning, and cost tracking.
- [Environments & Placements](https://docs.murmur.dev/concepts/environments-and-placements.md): How environments define VM specs and placements define where agents run.
- [Events](https://docs.murmur.dev/concepts/events.md): How PR comments, reviews, CI results, and other GitHub events reach running agents in real time.
- [Flights](https://docs.murmur.dev/concepts/flights.md): Declarative Markdown documents that orchestrate DAGs of agent tasks.
- [Core Concepts](https://docs.murmur.dev/concepts/overview.md): The mental model behind Murmur — how agents, workspaces, pools, flights, and events fit together.
- [VM Pools](https://docs.murmur.dev/concepts/pools.md): How the warm VM pool delivers instant agent startup.
- [Profiles &  Secrets](https://docs.murmur.dev/concepts/profiles-and-secrets.md): How your credentials are encrypted, transported, and protected.
- [Workspaces](https://docs.murmur.dev/concepts/workspaces.md): How workspaces organize repos, environments, and agents within a tenant.
- [Local Overlays](https://docs.murmur.dev/configuration/local-overlays.md): Per-developer configuration and environment variable overrides.
- [murmur.yaml Configuration](https://docs.murmur.dev/configuration/murmur-yaml.md): Complete reference for .murmur/murmur.yaml — workspace settings, model selection, and API configuration.
- [VM Environment](https://docs.murmur.dev/configuration/vm-environment.md): What's on agent VMs and how to customize the runtime environment.
- [Dashboard](https://docs.murmur.dev/dashboard/overview.md): A web UI for managing agents, steering work, and understanding what your agents have built.
- [Custom VM Images](https://docs.murmur.dev/guides/custom-images.md): Customize the agent VM environment with your language runtimes, SDKs, and tools.
- [Customer Placements](https://docs.murmur.dev/guides/customer-placements.md): Run agents in your own GCP or AWS account — advanced setup for teams that need compute in their cloud.
- [Getting Your Team Started](https://docs.murmur.dev/guides/developer-onboarding.md): Install the GitHub App, onboard developers, and get your team running agents.
- [Multi-Agent Orchestration](https://docs.murmur.dev/guides/multi-agent-orchestration.md): Patterns for orchestrating multiple agents — recursive spawning, flights, fanout, and parent-child coordination.
- [Welcome to Murmur](https://docs.murmur.dev/index.md): Orchestrate flocks of autonomous AI coding agents.
- [MCP Server Overview](https://docs.murmur.dev/mcp-server/overview.md): Use Murmur tools from within Claude Code sessions — spawn agents, manage tasks, and monitor progress via MCP.
- [MCP Tools Reference](https://docs.murmur.dev/mcp-server/tools.md): Complete reference for all 14 MCP tools — parameters, behavior, and response formats.
- [Developer Quickstart](https://docs.murmur.dev/quickstart.md): Developer quickstart guide to setup Murmur and spawn your first agent.
- [Authentication](https://docs.murmur.dev/security/authentication.md): How you and your agents authenticate to Murmur — GitHub OAuth, identity tokens, agent auth, and event pipeline security.
- [Authorization](https://docs.murmur.dev/security/authorization.md): Role-based access control — who can do what within your tenant.
- [Encryption](https://docs.murmur.dev/security/encryption.md): How Murmur encrypts your credentials at every stage — at rest, in transit, and on VMs.
- [Security Model](https://docs.murmur.dev/security/overview.md): How Murmur protects your credentials, isolates tenants, and enforces trust boundaries.
- [Troubleshooting](https://docs.murmur.dev/troubleshooting/common-issues.md): Common issues, error messages, and how to diagnose and fix them.