murmur CLI: install, authenticate, and configure

The murmur CLI is a single binary that manages agents, infrastructure, and configuration from your terminal.

Install

brew tap prassoai/tap
brew install prassoai/tap/murmur

Setup

After installing, run murmur setup to configure your credentials and connect to your tenant:

murmur setup

This walks you through tenant discovery, credential encryption, and writes your .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

murmur version

client: 0.4+a1b2c3d4
server: 0.4+e5f6a7b8 (api.murmur.sh:443)

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

Getting Started

Core Concepts

Guides

murmur CLI: install, authenticate, and configure

Install

Setup

Configuration

Verify

Commands

Agent lifecycle

Sessions

Events and subscriptions

Tasks

Catalog

Secrets

Connectivity

Pool management

Setup

​Install

​Setup

​Configuration

​Verify

​Commands

​Agent lifecycle

​Sessions

​Events and subscriptions

​Tasks

​Catalog

​Secrets

​Connectivity

​Pool management

​Setup

Install

Setup

Configuration

Verify

Commands

Agent lifecycle

Sessions

Events and subscriptions

Tasks

Catalog

Secrets

Connectivity

Pool management

Setup