CLI

The dispatched command-line tool manages authentication, workflows, and secrets from your terminal. Your private key never leaves your machine.

Install

# macOS (Apple Silicon)
curl -fsSL https://dispatched.work/cli/dispatched_darwin_arm64 -o /usr/local/bin/dispatched && chmod +x /usr/local/bin/dispatched

# macOS (Intel)
curl -fsSL https://dispatched.work/cli/dispatched_darwin_amd64 -o /usr/local/bin/dispatched && chmod +x /usr/local/bin/dispatched

# Linux (amd64)
curl -fsSL https://dispatched.work/cli/dispatched_linux_amd64 -o /usr/local/bin/dispatched && chmod +x /usr/local/bin/dispatched

# Linux (arm64)
curl -fsSL https://dispatched.work/cli/dispatched_linux_arm64 -o /usr/local/bin/dispatched && chmod +x /usr/local/bin/dispatched

The download URL always resolves to the latest release.

Setup

Run dispatched init to store your credentials locally:

dispatched init
# Host URL [http://localhost:4000]: https://dispatched.work
# Tenant ID: ten_abc123
# API Key: dsk_live_xxx
# Private Key (base64): <paste your key>

Credentials are saved to ~/.config/dispatched/credentials.json.

Authentication

# Start a session (performs DH handshake)
dispatched login

# Check session status
dispatched status

# Print session token (for use with curl)
dispatched token

Use the token with curl or httpie:

curl https://dispatched.work/api/workflows/my-workflow \
  -H "Dispatched-Session: $(dispatched token)"

Workflows

# Register a workflow from a YAML file
cat my-workflow.yaml | dispatched workflow register

# Show a workflow definition
dispatched workflow show my-workflow

# Delete a workflow
dispatched workflow delete my-workflow

Secrets

# List all secrets
dispatched secret list

# Set a secret
dispatched secret set STRIPE_KEY sk_live_xxx

# Delete a secret
dispatched secret delete STRIPE_KEY