​
SynapseX Orchestrators — Introdução

Terminal-native multi-agent runtime for local codebases. Spawn, coordene e faça merge de AI coding agents com git worktree isolation, persistent sessions, e um policy engine para execução paralela segura.

​
O que é

SynapseX Orchestrator é um runtime open-source local multi-agent para coding. Ele transforma AI agents em uma força de trabalho operacional que trabalha em paralelo em repositórios reais — com segurança, rastreabilidade e output mensurável.
Objetivo comercial: Enterprise control plane for safe, observable, governable agent fleets.
Objetivo OSS: Tornar um desenvolvedor individual produtivo imediatamente em um repositório local.

​
Por que SynapseX é melhor que Composio Agent Orchestrator

LayerComposio AOSynapseX
Workspace isolationgit worktreeworktree + Redis locks + snapshot/rollback
CI/review loopbasicfull event loop + replan + policy engine
Agent sessionsstatelessnamed, persistent, re-attachable
Tool layerComposio SDKMCP + tool catalog + sandbox + audit
Terminal UXCLI flagsTextual TUI + live status + streaming logs
Securityminimalcommand allowlist + sandbox + secret vault + audit trail

​
Features Principais

​
🤖 14 Agentes Especializados

AgenteRole
plannerDecomposes issues into structured task graphs
coderImplements code changes in isolated worktree
testerWrites pytest tests, reports coverage
debuggerRoot cause analysis, confidence-ranked fixes
reviewerSecurity + performance + correctness review, confidence score
docsAPI docs, READMEs, runbooks, docstrings
refactorClean code, SOLID principles
migrateDatabase migrations, schema upgrades
securitySecurity audits, CVE scanning
perfProfiling, memory/DB optimization
deployDeploy staging/production, CI/CD
scaffoldProject templates, boilerplate
translatei18n extraction, translation management
lint-fixAuto-linting, code formatting

​
🔄 Execução Multi-Agente

                    TASK INPUT
             "Implementar autenticação"
                      │
       ┌─────────────┼─────────────┐
       ▼             ▼             ▼
   ┌─────────┐  ┌─────────┐  ┌─────────┐
   │ Claude  │  │   GPT   │  │ Gemini  │
   │  Code   │  │   4o    │  │  2.0    │
   └────┬────┘  └────┬────┘  └────┬────┘
        └────────────┼────────────┘
                     ▼
         ┌───────────────────────┐
         │     CHAIRMAN LLM      │
         │  (Seleciona melhor     │
         │   solução + PR auto)   │
         └───────────────────────┘

​
🛡️ Policy Engine

O policy engine decide automaticamente o que fazer quando um job falha:
CondiçãoAção
Budget exceededABORT
Critical error (rate limit, auth)ESCALATE_HUMAN
Recurring error (2+ vezes)ESCALATE_HUMAN
CI failures ≥ 3SWITCH_MODEL (claude-opus-4-6)
Retry count < maxRETRY with exponential backoff
Review score < 0.6ESCALATE_HUMAN

​
Quick Start

​
1. Instale

pip install synapsex-orchestrator

# ou install de desenvolvimento
git clone https://github.com/softquantus/synapsex-orchestrator
cd synapsex_orchestrators
pip install -e ".[dev]"

​
2. Inicie a infraestrutura

# PostgreSQL + Redis via Docker
make up

# Execute migrations
make migrate

​
3. Configure

cp .env.example .env
# Defina ANTHROPIC_API_KEY, GITHUB_TOKEN, etc.

​
4. Inicialize seu repo

cd /path/to/your/repo
synapsex init

​
5. Start o control plane

synapsex server start

​
6. Spawn agentes

# Por perfil
synapsex spawn planner-1 --profile planner
synapsex spawn coder-1   --profile coder
synapsex spawn tester-1 --profile tester

# Com task e budget
synapsex spawn coder-2 --profile coder --task "implement JWT refresh" --budget 0.50

​
7. Submit jobs

synapsex jobs submit "Fix null pointer in auth module" --agent coder-1 --priority 2
synapsex jobs submit "Write tests for UserService" --type test
synapsex jobs list

​
8. Monitore

# Status live no terminal
synapsex status --watch

# Stream logs
synapsex logs coder-1 --follow

# Dashboard TUI completo
synapsex dashboard

​
9. Merge & Promote

# Review e merge
synapsex merge coder-1 --strategy squash

# Push e abra PR
synapsex promote coder-1 --title "feat: JWT refresh implementation"

# Rollback se necessário
synapsex rollback coder-1

​
Referência de Comandos

synapsex init [path]                  # Initialize in a repository
synapsex server start                 # Start the control plane
synapsex server status                # Check server health
synapsex spawn <name> [options]       # Spawn an agent
synapsex status [--watch]             # Show live status
synapsex logs <agent> [--follow]      # Stream agent logs
synapsex jobs list                    # List queued/running jobs
synapsex jobs submit <title>           # Submit a job
synapsex jobs cancel <job-id>         # Cancel a job
synapsex pause <agent>                # Pause an agent
synapsex resume <agent>               # Resume a paused agent
synapsex merge <agent>                # Merge agent's work
synapsex promote <agent>             # Push branch and open PR
synapsex rollback <agent>             # Rollback to snapshot or base
synapsex dashboard                    # Open TUI dashboard

​
Próximos Passos

GuiaDescrição
Getting StartedSetup detalhado e configuração
CLI ReferenceReferência completa de comandos
ArchitectureDetalhes técnicos
GitHubRepositório oficial