CLI Reference

minion-cli is the management CLI available on minion VPS instances.

Basic commands

Health check

minion-cli health

Checks the minion server status.

Status

minion-cli status

Displays agent state, uptime, version, and HQ connection status.

Skill management

List skills

# List skills on HQ
minion-cli skill list

# List locally deployed skills
minion-cli skill list --local

Fetch skill

# Fetch a skill from HQ and deploy locally
minion-cli skill fetch <name>

Push skill

# Push a local skill to HQ (new version auto-created)
minion-cli skill push <name>

Workflow management

Fetch workflow

# Fetch a workflow from HQ (missing skills are auto-fetched)
minion-cli workflow fetch <name>

Push workflow

# Push a local workflow to HQ (skills are auto-pushed)
minion-cli workflow push <name>

Troubleshooting

Unknown agent state

minion-cli health
minion-cli status

Skill not found

# Check local skill list
minion-cli skill list --local

# Re-fetch from HQ
minion-cli skill fetch <name>

Workflow not executing

You can inspect and trigger workflows directly via the Agent API.

# List workflows (check next_run)
curl -s "http://localhost:3001/api/workflows" \
  -H "Authorization: Bearer $API_TOKEN"

# Manual trigger
curl -s -X POST "http://localhost:3001/api/workflows/trigger" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "workflow_id": "<workflow-uuid>" }'