​
Blackbox CLI — Introdução

A Blackbox CLI é a interface de linha de comando unificada para toda a plataforma SynapseX. Permite controlar agentes, jobs, integrações e o gateway MCP a partir do terminal.

​
O que é

A Blackbox CLI é o ponto de entrada central para operações da plataforma:
  • Gerenciar agentes - Spawn, pause, resume, merge
  • Controlar jobs - Submit, list, cancel
  • Acessar tools - Executar ferramentas do SynapseX Manager
  • Gateway MCP - Iniciar e configurar o servidor MCP

​
Instalação

​
Via pip

pip install blackbox-cli

​
Via desenvolvimento

cd blackbox-cli
pip install -e .

​
Verificar instalação

blackbox --version
blackbox --help

​
Comandos Disponíveis

​
Infraestrutura

blackbox up              # Inicia infraestrutura (Docker)
blackbox down            # Para infraestrutura
blackbox status          # Verifica status dos serviços

​
MCP Gateway

blackbox mcp start       # Inicia gateway MCP
blackbox mcp stop        # Para gateway MCP
blackbox mcp status      # Verifica status

​
Agentes

blackbox agents spawn --name coder-1 --profile coder
blackbox agents list
blackbox agents status coder-1
blackbox agents pause coder-1
blackbox agents resume coder-1
blackbox agents merge coder-1
blackbox agents logs coder-1 --follow

​
Jobs

blackbox jobs submit "Implementar feature X" --agent coder-1
blackbox jobs list
blackbox jobs cancel <job-id>

​
Time Completo

blackbox team spawn --task "Implementar sistema de pagamentos"

​
Configuração

​
Variáveis de Ambiente

# Required
export SYNAPSEX_API_KEY=sk-synapsex-...
export SYNAPSEX_SERVER_URL=https://api.synapsex.ai

# Optional
export SYNAPSEX_DEFAULT_MODEL=claude-sonnet-4-6
export SYNAPSEX_TEMPERATURE=0.7

​
Arquivo de Configuração

Crie ~/.blackbox/config.json: 
{
  "api_key": "sk-synapsex-xxxxx",
  "server_url": "https://api.synapsex.ai",
  "defaults": {
    "model": "claude-sonnet-4-6",
    "temperature": 0.7,
    "max_tokens": 4000
  },
  "profiles": {
    "coder": {
      "model": "claude-sonnet-4-6"
    },
    "reviewer": {
      "model": "gpt-4o"
    }
  }
}

​
Fluxo de Uso Típico

​
1. Iniciar infraestrutura

blackbox up

​
2. Spawnar agentes

blackbox agents spawn --name planner-1 --profile planner
blackbox agents spawn --name coder-1 --profile coder
blackbox agents spawn --name tester-1 --profile tester

​
3. Submeter tarefa

blackbox run --agent coder-1 --task "Implementar autenticação JWT" --wait

​
4. Revisar e fazer merge

blackbox agents logs coder-1
blackbox agents merge coder-1 --strategy squash

​
Opções Globais

OpçãoDescrição
--configCaminho customizado para config
--debugHabilitar output de debug
--jsonOutput em JSON
--quietSuprimir output não essencial

​
Resolução de Problemas

​
Comando não encontrado

# Verificar instalação
pip show blackbox-cli

# Reinstalar
pip install --upgrade blackbox-cli

​
API key inválida

# Verificar configuração
blackbox auth status

# Configurar API key
blackbox auth set-key sk-synapsex-xxxxx

​
Próximos Passos

GuiaDescrição
CLI ReferenceReferência completa de comandos
OrchestratorsRuntime de agentes
ManagerIntegrações