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 signs you in, walks you through tenant and workspace selection and credential encryption, and writes your .murmur/murmur.yaml configuration. See murmur setup for details. In a repo that is already configured, run murmur login to sign in again without repeating setup.

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. Default: `api.murmur.dev:9090`.
`tenant.provider`	Identity provider (`github_oauth`, `github_app`, `google_oidc`)
`tenant.org`	Your GitHub org or username

Verify

murmur version

Client: 0.4 (a1b2c3d4)
API:    api.murmur.dev:9090
Server: 0.4 (e5f6a7b8)

Commands

Agent lifecycle

Command	Purpose
`murmur spawn`	Start an agent
`murmur status`	Query an agent’s current state
`murmur ls`	List agents
`murmur timeline`	Stream an agent’s lifecycle timeline
`murmur turns`	List an agent’s folded turns
`murmur kill`	Cancel an agent
`murmur delete`	Permanently destroy an agent and its subtree
`murmur suggest-terminate`	Advise that an agent be terminated
`murmur wait`	Block until an agent reaches a target phase
`murmur sleep`	Stop an agent’s VM
`murmur wake`	Restart a stopped VM
`murmur on-idle`	Change a running agent’s idle behavior
`murmur autopilot-timeout`	Set how long an agent acts on CI and PR events by itself
`murmur can`	Restart an agent on the current software version
`murmur each`	Fanout: spawn one agent per stdin line
`murmur rekey`	Rotate credentials on a running agent
`murmur credentials`	Report what credentials an agent runs on
`murmur spawn-profiles`	List the identities you can spawn an agent as
`murmur resume`	Resume an agent’s session locally
`murmur upload`	Upload files and print public URLs
`murmur history`	List every run the tenant has executed

GitHub

Command	Purpose
`murmur install-repo`	Configure event delivery for a repo

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
`murmur session download`	Download an agent’s session file
`murmur session search`	Search completed agent turns

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 front`	Move a queued follow-up to the front
`murmur queue remove`	Remove one undelivered follow-up
`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

Dashboard folders and tags

Command	Purpose
`murmur folder ls`	List your folders and their agent counts
`murmur folder create`	Create a folder holding no agents
`murmur folder rename`	Change a folder’s label
`murmur folder rm`	Delete a folder, unfiling its agents
`murmur folder assign`	File agents under a folder
`murmur folder unfile`	Return agents to the Unfiled group
`murmur tag ls`	List the tags an agent carries
`murmur tag add`	Attach tags to an agent
`murmur tag rm`	Detach tags from an agent

Catalog

Command	Purpose
`murmur get`	Read a resource or list all of a kind
`murmur defaults`	Get a creation template for 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 history ls`, `show`, `revert`	Catalog resource version history
`murmur change-request`	Approve, reject, withdraw, or endorse change-requests
`murmur bake`	Bake a recipe into a VM image
`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
`murmur secret mount`	Deliver one of your own secrets to every VM you spawn
`murmur secret unmount`	Stop delivering a mounted secret
`murmur secret mounts`	List your mounted secrets

Connectivity

Command	Purpose
`murmur ssh`	SSH into an agent’s VM
`murmur editor`	Print (or open) the browser VS Code URL for 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 and resources

Command	Purpose
`murmur pool status`	Show pool state
`murmur pool up`	Start the pool
`murmur pool flush`	Drain warm VMs
`murmur resource`	List placement resources (VMs, disks, images)

Setup

Command	Purpose
`murmur setup`	Configure credentials and tenant
`murmur setup subscription`	Manage Claude and Codex subscriptions
`murmur setup connection`	Manage inference connections
`murmur login`	Sign in and store the identity in the OS keychain
`murmur logout`	Remove the stored identity from the OS keychain
`murmur init`	Onboarding wizard for new repos
`murmur auth`	Run Claude OAuth flow
`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

GitHub

Sessions

Events and subscriptions

Tasks

Dashboard folders and tags

Catalog

Secrets

Connectivity

Pool and resources

Setup

​Install

​Setup

​Configuration

​Verify

​Commands

​Agent lifecycle

​GitHub

​Sessions

​Events and subscriptions

​Tasks

​Dashboard folders and tags

​Catalog

​Secrets

​Connectivity

​Pool and resources

​Setup

Install

Setup

Configuration

Verify

Commands

Agent lifecycle

GitHub

Sessions

Events and subscriptions

Tasks

Dashboard folders and tags

Catalog

Secrets

Connectivity

Pool and resources

Setup