​
Command Reference

​
Global Flags

synapsex --version          # Installed version
synapsex --help             # General help
synapsex --debug <cmd>      # Debug mode
synapsex --json <cmd>       # JSON output
synapsex --config <path>    # Custom config path

​
Agent Commands

​
Run an agent

synapsex agent run --task "refactor the auth module" --repo ./my-app
sx agent run --task "add unit tests" --model azure/gpt-4-1-teacher

​
List running agents

synapsex agent list
synapsex agent list --status running

​
Get agent status

synapsex agent status <agent-id>

​
Stop an agent

synapsex agent stop <agent-id>

​
API Key Commands

synapsex keys list                          # List all keys
synapsex keys create --name "my-app"        # Create a new key
synapsex keys revoke <key-id>               # Revoke a key

​
Configuration

synapsex config set api-url https://api.synapsex.ai
synapsex config set api-key sx-...
synapsex config show

​
Models

List all available models: 
synapsex models list
synapsex models list --provider azure
Available Azure models:
  • azure/gpt-4-1-teacher — GPT-4.1 (recommended)
  • azure/gpt-4o — GPT-4o
  • azure/gpt-4o-mini — GPT-4o Mini (fast, cheap)
  • azure/o3 — o3 reasoning
  • azure/o4-mini — o4-mini