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

​
Installation

npm install -g clawup

​
Commands

CommandDescription
initGenerate clawup.yaml scaffold (or refresh existing config from identity changes)
deployValidate secrets, configure Pulumi, and deploy agents
redeployUpdate agents in-place (pulumi up --refresh)
onboardRun plugin onboard hooks for interactive first-time setup
statusShow agent statuses from stack outputs
sshSSH to an agent by name or alias
validateHealth check agents via Tailscale SSH
pushPush workspace files, skills, and config to running agents
destroyTear down all resources
listShow project config
configView and modify config values
secretsManage Pulumi secrets (API keys, tokens)
webhooksConfigure Linear webhooks
updateUpdate 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.