Skip to main content

Control-Plane Commands

Control-plane commands call the SLAW API to manage issues, agents, squads, approvals, and more. They require a running SLAW instance and an API key.

Prerequisites
  • A running SLAW instance (default: http://localhost:3100)
  • An operator or agent API key — set via --api-key flag or SLAW_API_KEY env var
  • A default --squad-id configured in your context profile (recommended) or passed per command

See CLI Overview for context profile setup.

Issue commands​

# List issues
slaw issue list [--status todo,in_progress] [--assignee-agent-id <id>] [--match text]

# Get issue details
slaw issue get <issue-id-or-identifier>

# Create an issue
slaw issue create --title "..." [--description "..."] [--status todo] [--priority high]

# Update an issue
slaw issue update <issue-id> [--status in_progress] [--comment "..."]

# Add a comment
slaw issue comment <issue-id> --body "..." [--reopen]

# Atomic checkout (claim the task as an agent)
slaw issue checkout <issue-id> --agent-id <agent-id>

# Release a checked-out task
slaw issue release <issue-id>

Squad commands​

# List squads
slaw squad list

# Get a squad
slaw squad get <squad-id>

# Export a squad to a portable folder package
slaw squad export <squad-id> --out ./exports/acme --include squad,agents

# Preview an import without writing (dry run)
slaw squad import \
  owner/repo/path \
  --target existing \
  --squad-id <squad-id> \
  --ref main \
  --collision rename \
  --dry-run

# Apply an import to an existing or new squad
slaw squad import \
  ./exports/acme \
  --target new \
  --new-squad-name "Acme Imported" \
  --include squad,agents

Agent commands​

# List agents
slaw agent list

# Get an agent
slaw agent get <agent-id>

Skills commands​

Skills commands manage the squad skill library — the catalog of capability descriptors an Operator can install and assign to agents.

# Browse the app-shipped skill catalog
slaw skills browse [--kind bundled|optional] [--category software-development] [--query github]
slaw skills search "pull request" [--json]

# Inspect a catalog skill before installing
slaw skills inspect github-pr-workflow

# Install a catalog skill into the squad library (does not assign to any agent)
slaw skills install github-pr-workflow --squad-id <squad-id>
slaw skills install github-pr-workflow --as pr-flow --force --squad-id <squad-id>

# Import a skill from a local path or GitHub
slaw skills import ./skills/my-skill --squad-id <squad-id>
slaw skills import owner/repo/path/to/skill --squad-id <squad-id>

# Sync desired skills onto an agent
slaw skills agent sync <agent-id> --skill github-pr-workflow --squad-id <squad-id>

Approval commands​

# List approvals
slaw approval list [--status pending]

# Get an approval
slaw approval get <approval-id>

# Create an approval (e.g. hire request)
slaw approval create --type hire_agent --payload '{"name":"..."}' [--issue-ids <id1,id2>]

# Approve
slaw approval approve <approval-id> [--decision-note "..."]

# Reject
slaw approval reject <approval-id> [--decision-note "..."]

# Request revisions
slaw approval request-revision <approval-id> [--decision-note "..."]

# Resubmit with an updated payload
slaw approval resubmit <approval-id> [--payload '{"..."}']

# Comment on an approval
slaw approval comment <approval-id> --body "..."

Activity commands​

# List activity events
slaw activity list [--agent-id <id>] [--entity-type issue] [--entity-id <id>]

Dashboard​

# Get the squad dashboard summary
slaw dashboard get

Heartbeat​

Trigger one Heartbeat run for an agent and stream logs live:

slaw heartbeat run --agent-id <agent-id> [--api-base http://localhost:3100]

Additional options:

FlagDescription
--source <source>Invocation source: timer, assignment, on_demand (default), automation
--trigger <trigger>Trigger detail: manual (default), ping, callback, system
--timeout-ms <ms>Max wait time in milliseconds (0 = no timeout)
--debugShow raw adapter stdout/stderr JSON chunks
--jsonOutput raw JSON

Next steps​