CLI reference

# Bootstrap a new agent with auto-start
op agent bootstrap my_agent -d "Processes incoming webhooks"

# Bootstrap without starting (for manual setup)
op agent bootstrap my_agent --no-start

# Bootstrap on specific daemon
op agent bootstrap my_agent --daemon production

# The agent is created at ~/.config/opperator/agents/my_agent/

# List available agents
op agent list

# List only running agents
op agent list --running

# Start specific agent
op agent start my_agent

# Follow logs to verify
op agent logs my_agent -f

# View last 100 lines
op agent logs my_agent -n 100

# Stop specific agent
op agent stop my_agent

# Stop all agents
op agent stop --all

# Delete with confirmation prompt
op agent delete old_agent

# Force delete without confirmation
op agent delete old_agent -f

# This removes:
# - Agent directory and files
# - Configuration entry (agents.yaml)
# - Persistent data (agent_data.json)
# - All logs and async tasks

# Create a secret for API key (will prompt for value)
op secret create GITHUB_TOKEN

# Or provide the value inline
op secret create GITHUB_TOKEN ghp_xxxxx

# Verify it exists
op secret status GITHUB_TOKEN

# List all secrets
op secret list

# Update a secret
op secret update GITHUB_TOKEN

# Delete a secret
op secret delete GITHUB_TOKEN

# List all background tasks
op async list

# Filter by status
op async list --status running

# Filter by session
op async list --session sess_abc123

# Get details for specific task
op async get task_12345

# Clean up completed task
op async delete task_12345

# Run diagnostics
op doctor

# Check daemon status
op daemon status

# View agent logs (all lines)
op agent logs my_agent

# View last 100 lines
op agent logs my_agent -n 100

# Follow logs in real-time
op agent logs my_agent -f

# Deploy new cloud VPS (interactive wizard)
op cloud deploy

# Verify deployment
op cloud list

# Push updates to cloud daemon
op cloud update my-cloud-daemon

# Update with pre-release version
op cloud update my-cloud-daemon --pre-release

# Destroy when done
op cloud destroy my-cloud-daemon

# Force destroy without confirmation
op cloud destroy my-cloud-daemon --force

# Find agent location
op agent where my_agent

# Move to different daemon
op agent move my_agent --to production

# Move without auto-starting
op agent move my_agent --to staging --no-start

# Force move (resolve conflicts)
op agent move my_agent --to prod --force

# Verify new location
op agent where my_agent

# List available commands for an agent
op agent commands my_agent

# Execute a command
op agent command my_agent process_data

# Execute with arguments
op agent command my_agent process_item --args '{"id": 123, "type": "webhook"}'

# Execute with timeout
op agent command my_agent long_running_task --timeout 10m

# Execute on specific daemon
op agent command my_agent status --daemon production

# Show all agents
op agent list

# Show only running agents
op agent list --running

# Show only stopped agents
op agent list --stopped

# Show only crashed agents
op agent list --crashed

# Show agents on specific daemon
op agent list --daemon production

which op
# or
which opperator

op daemon status

op daemon start

# Run diagnostics
op doctor

# Check agent logs
op agent logs <agent-name>

# Verify agent exists
op agent list

# List all agents across all daemons
op agent list

# Check which daemons are enabled
op daemon list

# Test daemon connectivity
op daemon test <daemon-name>

# Find specific agent location
op agent where <agent-name>

# See all locations
op agent where <agent-name>

# Delete duplicates or use force move
op agent delete <agent-name> --daemon <daemon-name> -f
op agent move <agent-name> --to <target-daemon> --force

# Verify daemon configuration
op daemon list

# Test connectivity
op daemon test <daemon-name>

# Update token if authentication fails
op daemon remove <daemon-name>
op daemon add <daemon-name> <address> --token=$NEW_TOKEN --enabled

# Check specific secret
op secret status <secret-name>

# List all secrets
op secret list

# Create if missing
op secret create <secret-name>

# Verify cloud deployment exists
op cloud list

# Check SSH key configuration
# Ensure your SSH key is added to the cloud provider

# Destroy and redeploy if needed
op cloud destroy <daemon-name> --force
op cloud deploy