murmur CLI is a single binary that manages agents, infrastructure, and configuration from your terminal.
Install
Setup
After installing, runmurmur setup to configure your credentials and connect to your tenant:
.murmur/murmur.yaml configuration. See murmur setup for details.
Configuration
The CLI reads configuration from.murmur/murmur.yaml in your repository. It walks up from the current directory to find the nearest config file. A local overlay (.murmur/murmur.local.yaml, gitignored) lets you override settings per-developer without affecting the team config. See murmur.yaml configuration and local overlays for details.
Key settings:
| Field | Purpose |
|---|---|
workspace | Default workspace for spawns |
api.address | API server address |
tenant.provider | Identity provider (github_oauth, github_app) |
tenant.org | Your GitHub org or username |
Verify
Commands
Agent lifecycle
| Command | Purpose |
|---|---|
murmur spawn | Start an agent |
murmur status | Query an agent’s current state |
murmur ls | List agents |
murmur kill | Cancel an agent |
murmur wait | Block until an agent reaches a target phase |
murmur sleep | Stop an agent’s VM |
murmur wake | Restart a stopped VM |
murmur each | Fanout — spawn one agent per stdin line |
murmur rekey | Rotate credentials on a running agent |
murmur upload | Upload files and print public URLs |
Sessions
| Command | Purpose |
|---|---|
murmur session watch | Stream live session events |
murmur session send | Send a follow-up message |
murmur session interrupt | Interrupt the current turn |
murmur session stop | Request graceful shutdown |
Events and subscriptions
| Command | Purpose |
|---|---|
murmur watch | Stream mailbox events |
murmur notify | Publish an event to an agent |
murmur queue add | Send a follow-up to an agent’s queue |
murmur queue clear | Discard queued follow-ups |
murmur queue strategy | Set how the agent drains its queue |
murmur queue conflict-resolution | Set per-repo conflict handling |
murmur subscriptions add | Subscribe to branch/file events |
murmur subscriptions remove | Unsubscribe |
murmur subscriptions flush | Remove all subscriptions |
murmur subscriptions ls | List subscriptions |
Tasks
| Command | Purpose |
|---|---|
murmur task create | Create a checklist item |
murmur task update | Update a task’s status or description |
murmur task ls | List tasks |
murmur task get | Get a single task |
Catalog
| Command | Purpose |
|---|---|
murmur get | Read a resource or list all of a kind |
murmur set | Create or replace a resource |
murmur patch | Partial update |
murmur rm | Delete a resource |
murmur describe | Show a kind’s schema |
murmur bake | Trigger image baking |
murmur bakes ls | List bake workflows |
Secrets
| Command | Purpose |
|---|---|
murmur secret set | Set a secret |
murmur secret ls | List secrets |
murmur secret rm | Delete a secret |
Connectivity
| Command | Purpose |
|---|---|
murmur ssh | SSH into an agent’s VM |
murmur port-forward | Tunnel to a VM port |
murmur url port | Print a port-proxy URL (VM only) |
murmur url agent | Print the dashboard URL for an agent |
Pool management
| Command | Purpose |
|---|---|
murmur pool status | Show pool state |
murmur pool up | Start the pool |
murmur pool flush | Drain warm VMs |
Setup
| Command | Purpose |
|---|---|
murmur setup | Configure credentials and tenant |
murmur init | Onboarding wizard for new repos |
murmur auth | Run Claude OAuth flow |
murmur install-repo | Configure event delivery for a repo |
murmur director | Start an interactive director session |
murmur check-permissions | Evaluate permissions |
murmur mcp | Run as MCP server |
murmur version | Print version |