CLI Overview - Clawup

The Clawup CLI is the primary interface for managing your agent team: setup, deployment, monitoring, access, and teardown.

Installation

npm install -g clawup

Commands

Command	Description
`init`	Generate clawup.yaml scaffold (or refresh existing config from identity changes)
`deploy`	Validate secrets, configure Pulumi, and deploy agents
`redeploy`	Update agents in-place (`pulumi up --refresh`)
`onboard`	Run plugin onboard hooks for interactive first-time setup
`status`	Show agent statuses from stack outputs
`ssh`	SSH to an agent by name or alias
`validate`	Health check agents via Tailscale SSH
`push`	Push workspace files, skills, and config to running agents
`destroy`	Tear down all resources
`list`	Show project config
`config`	View and modify config values
`secrets`	Manage Pulumi secrets (API keys, tokens)
`webhooks`	Configure Linear webhooks
`update`	Update the clawup CLI to the latest version

Local Docker Mode

Most commands that operate on deployments support --local to target local Docker containers instead of cloud infrastructure:

clawup deploy --local       # Deploy locally
clawup redeploy --local     # Redeploy local containers
clawup status --local       # Check local container status
clawup ssh titus --local    # Shell into local container
clawup validate --local     # Health check local containers
clawup push --local         # Push files to local containers
clawup destroy --local      # Tear down local containers

Global Options

clawup --version    # Show version
clawup --help       # Show help
clawup <cmd> --help # Show command-specific help

Project-Based Config

Every deployment lives in a project directory with clawup.yaml at its root. Run commands from within your project directory and the CLI auto-detects the config.

​Installation

​Commands

​Local Docker Mode

​Global Options

​Project-Based Config

Installation

Commands

Local Docker Mode

Global Options

Project-Based Config