Claude Code
Terminal agent nativo com tool use profundo e subagents paralelos
github.com/IAPro-Community/nexus Sua workstation local
Sua workstation local
para coding agents.
Transforme objetivos em trabalho executável: coordene agents persistentes, escolha recursos de IA e só conclua quando houver evidência verificável.
Suportado hoje:
Linux amd64Windows amd64macOS arm64macOS Intel
Para começar, o caminho recomendado é Direct: Project → + New → AI Session → Provider → Terminal.
$ curl -fsSL https://nexus.iapro.club/install.sh | bash
# Baixando release verificada...
# nexus instalado em ~/.local/bin/nexus
$ nexus doctor --check-all
✓ SQLite local pronto ✓ Git worktrees ok ✓ Provedores CLI detectados
$ ./nexus web
🚀 Nexus Workstation UI ativa em http://localhost:8080
$
$ nexus worktree create feat/checkout --agent claude
✓ Worktree isolado em .worktrees/feat/checkout
✓ Agent Claude Code conectado com branch dedicada
$ nexus run --task "corrigir validação de checkout"
● Analisando src/checkout/validators.ts...
● 1 comando executado: PASS 18 testes
✓ Missão concluída com evidência verificada
$
$ nexus team run --spec ACTIVE.md
● Lead: Orquestrador Maestro ativo (planejamento & roteamento)
● Worker 1: Claude Code -> Implementação em worktree isolado
● Worker 2: Codex -> Testes e cobertura E2E
● Gatekeeper: Verificação de contraste WCAG AA aprovada
✓ Todas as 4 workstreams sincronizadas com sucesso
$
1 Core Web, Desktop e CLI operando o mesmo estado
3 superfícies visual, nativa e headless
4 plataformas Linux amd64 · Windows amd64 · macOS arm64/Intel
0 telemetria de terceiros
Agentes & Modelos
Traga seus próprios agents. Comande a frota.
O Nexus roda 100% local no seu terminal. Integre os agents CLI que você já assina ou roda localmente, cada um em seu próprio worktree isolado.
OpenAI Codex
Execução de código precisa com raciocínio e diffs verificados
OpenCode
Client multi-provedor open source de alto desempenho para terminal
Google Gemini
Janela de contexto ultra-longa para assimilação de repositórios inteiros
xAI Grok
Raciocínio rápido e geração de código full-stack
Antigravity
Orquestração autônoma e fluxos baseados em evidência verificável
Pi / oh-my-pi
Multiplexing de terminal e agents leves e resilientes
Cursor CLI
Indexação de repositório e navegação semântica rápida
Core
Tudo o que o Nexus reúne em um só Core
Um sistema único para operar coding agents — não uma colcha de retalhos de scripts.
Projects e Workspaces
Áreas de trabalho locais com contexto, terminais e configuração isolados por projeto.
Agents persistentes
Um Agent é uma identidade durável. Codex, Claude, Gemini, entre outros, são executores selecionáveis sob capacidade e policy.
Providers, perfis e quota
Modelos, perfis e limites gerenciados no Core, sem acoplar o papel do agente a um provider.
Terminais e runtimes supervisionados
Execução com supervisão, diagnóstico em nexus doctor e scripting headless via CLI.
Planos e Diretrizes Versionadas
Intenção estruturada em planos de trabalho versionados com etapas claras e critérios de aceite antes da execução.
Missions duráveis
Execução sob políticas, gates e isolamento, com GO como boundary real e recuperação diante de falhas.
Worktrees isolados e scheduler
Escrita paralela segura em worktrees e políticas de recurso para agents e runtimes.
Evidência e Definition of Done
Receipts, artifacts, memória e verificação: "done" textual não é sucesso. O destino é COMPLETED_VERIFIED.
Fluxo
Como o Nexus funciona
De um objetivo em texto até um resultado verificado — com você autorizando cada materialização.
Objetivo
Você descreve o que quer atingir, em linguagem natural, dentro de um Project.
Plano de Trabalho
A intenção se estrutura em um plano versionado: etapas, dependências e critérios de aceite.
Autorização (GO)
Você revisa e autoriza uma versão específica do plano antes de executar — é um boundary real.
Mission + Agents
A Missão executa sob políticas, worktrees isolados e quotas, coordenando agents pelo protocolo fechado.
Evidência → COMPLETED_VERIFIED
Testes, artifacts e Definition of Done decidem. "Done" textual não fecha a missão.
Agent ≠ provider
Um Agent é uma identidade persistente com papel e memória. Codex, Claude, Gemini e outros executores são recursos que podem ser selecionados conforme capacidade, policy e disponibilidade — trocar de provider não troca o seu agente.
Agent → AgentSpec → AgentRevision → RuntimeGeneration → ProviderSession
Isso evita acoplar o papel do trabalhador a um provider específico: modelos mudam, o agente continua.
Coordenação entre agents
Agents não conversam soltos: toda coordenação passa pelo MissionRunner, que tenta memória e receipts antes de criar outra execução e bloqueia replay quando não há prova de segurança.
NEED_INFOARTIFACT_REQUESTREVIEW_REQUESTDELEGATE
Fail closed, por padrão
- Push e deploy não são permissões implícitas
- Reviewers e investigators são read-only
- Escrita paralela só em worktrees isolados
- Retries e no-progress são limitados
- Ausência de evidência não vira sucesso
- Mudanças materiais exigem intervenção humana
Três superfícies, um Core
Web
operação visual local: Projects, Agents, Workspaces e Missions
Desktop
shell nativo quando a plataforma tem evidência correspondente
CLI
automação, diagnóstico, scripting e execução headless
O HUD projeta em tempo real o estado do Core — Capacity, Scheduler, Custos, Agents e Missions — no Web OS e em um gadget nativo.
Diferenciais
Por que o Nexus é diferente
Não é outro chat de IA: é um runtime completo para coordenar trabalho de software.
Conclusão por evidência
A missão só fecha com COMPLETED_VERIFIED: testes, artifacts e Definition of Done. Nada de "feito" declarado.
Você autoriza cada plano
O GO é um boundary real: nada executa sem a sua aprovação de uma revisão específica do plano.
Sem lock-in de provider
Agent ≠ provider: seu agente sobrevive à troca de modelo. Capacity e routing são escolhidos pelo Core.
Fail closed em tudo
Permissões de push/deploy não são implícitas; sem evidência, não há sucesso; replay sem prova é bloqueado.
Paralelismo seguro
Worktrees isolados, scheduler e políticas de recurso deixam agents trabalhando juntos sem colisão.
Local-first
Workspaces, terminais, runtimes e memória rodam na sua máquina — o Nexus dá status, não dá data de você.
Tour
Veja o Nexus por dentro
Capturas reais do produto — nada de mocks.
O tour visual completo fica em docs/product/visual-tour.md no repositório.
Inteligência
Orquestrador Maestro — a camada de inteligência
O Nexus é o runtime. O Maestro é o método que governa o que os agents fazem dentro dele.
Kit de orquestração de AI agents, open source (Apache-2.0), que roda junto ao Nexus CLI e às suas ferramentas favoritas: Codex, Claude, OpenCode, Cursor, Gemini, Windsurf e mais. Em vez de deixar a IA decidir sozinha o que ler e declarar "pronto" sem prova, o Maestro organiza o caminho antes da execução — com verificação e handoff como parte do trabalho.
Lead • Orquestrador Maestro
Decisão & Roteamento
Planeja, Roteia e Sintetiza
Mantém a memória durável e distribui as fatias de código para os agents especialistas em worktrees isolados, mantendo o humano no controle de cada merge.
📐 Spec & Contrato ACTIVE.md
Escopo delimitado e critérios de aceite antes de tocar no código.
⚡ Implementação Worktree #1
Claude Code ou Codex executando fatias limpas sem colisões de branch.
🧪 Verificação Smoke & Diffs
Execução observável dos caminhos alterados. Evidência em log real.
🛡️ Quality Gate WCAG AA
Auditoria de contraste de tokens e integridade da arquitetura.
Nexus
execução: agents, runtimes, providers, workspaces, UX e evidência
Maestro
metodologia: skills, risco, gates e políticas de verificação
Apache-2.056 skills canônicas79 skills públicasRouter v3V1 estável
O que o Maestro traz
- Complexity Gate + Router v3: a skill certa e o contexto proporcional ao problema — de 1.5k tokens em tarefas MICRO a 16k nas DEEP
- Resolution Engine: separa processo encerrado de Validated Outcome, com Evidence e Proof Bundle
- 56 skills canônicas e 79 públicas: do planejamento à release engineering e segurança
- Memória durável em DEV/: objetivo, decisões e verificação vivem no projeto, não no histórico do chat
- Privacidade por padrão: telemetria desligada; o seu conteúdo permanece local
$ npm install -g @iapro/orquestrador-maestro-cli@latest
$ orquestrador-maestro install
$ orquestrador-maestro verify
Sem o Maestro: O Nexus não fica cego: Direct, Workspaces, Terminal e Mission continuam sendo capacidades nativas. O Maestro é método acumulado, não uma dependência para funcionar.
Modos
Escolha o modo pelo tamanho do problema
De uma correção pequena até trabalho longo multi-agent com gates.
| Situação | Use |
|---|---|
| Correção pequena, debugging, exploração | Direct |
| Sessão supervisionada no terminal | Terminal |
| Trabalho longo, multi-Agent, com gates | Mission |
| Metodologia, skills e gates externos | Maestro (opcional) |
Mission e Maestro não são pré-requisitos: para começar, Direct já basta.
Download
Faça o download
Duas formas de colocar o Nexus para rodar: app nativo no seu PC ou Nexus Web compilado direto do source.
A
App nativo no PC
Binários do pipelines oficiais para Linux, Windows e macOS: Desktop, CLI e HUD por plataforma. Sem telemetria de terceiros.
Download ↓B
Nexus Web via git clone
Compile o workspace Web localmente a partir do source. É o caminho recomendado para primeiro uso e desenvolvimento.
$ git clone https://github.com/IAPro-Community/nexus.git
$ cd nexus
$ bun --cwd web install --frozen-lockfile
$ make build
$ ./nexus doctor
$ ./nexus web
Baixe por plataforma
Cada card abaixo lista os assets do release atual daquele sistema, do CI oficial do projeto.
Preview não assinado: Os binários atuais são previews de desenvolvimento gerados por CI: sem certificado Authenticode, Developer ID ou notarização. Windows SmartScreen e macOS Gatekeeper podem avisar. Não são releases estáveis.
Linux
tar -xzf nexus-*.tar.gz && sudo mv nexus /usr/local/bin/ && nexus doctor
Windows
Extraia o .zip e rode nexus.exe doctor no terminal.
macOS
[cli] nexus-preview-macos-arm64-cli.tar.gz 8.8 MB [desktop] nexus-preview-macos-arm64-desktop.zip 9.5 MB [hud] nexus-preview-macos-arm64-hud.zip 9.5 MB
tar -xzf nexus-*.tar.gz && sudo mv nexus /usr/local/bin/
macOS
[cli] nexus-preview-macos-intel-cli.tar.gz 9.3 MB [desktop] nexus-preview-macos-intel-desktop.zip 10.0 MB [hud] nexus-preview-macos-intel-hud.zip 10.0 MB
tar -xzf nexus-*.tar.gz && sudo mv nexus /usr/local/bin/
install.sh / install.ps1 — Os scripts de instalação do repo acompanham releases certificadas. Enquanto isso não acontecer, use os assets do preview ou compile do source.
Pacotes nativos (.deb para Linux; instaladores assinados para Windows e macOS) entram no site conforme forem certificados pelo programa exact-SHA — acompanhe o status de release.
Como o build chega até você
Nada é anunciado estável sem evidência: cada passo é preso a um SHA exato e a gates de certificação.
CI gera o preview
Runners GitHub compilam Linux amd64, Windows amd64, macOS arm64 e Intel a cada mergulho em desenvolvimento.
Snapshot imutável
O build é publicado em uma tag preview-<SHA> com SHA256SUMS.txt. A versão e o source são reconstruíveis bit-a-bit.
Certificação exact-SHA
Jobs nativos certificam o MESMO SHA de source por plataforma: assinatura, notarização e testes antes de qualquer anúncio.
Release estável assinada
Só depois da certificação o release entra nos canais estáveis. Updates assinados nunca apontam para tags preview.
LIVECACHEDESTIMATEDVERIFIEDUNVERIFIED
Docs
Documentação
A entrada canônica é docs/README.md no repositório.
Quick Start Instale e faça a primeira execução em minutos. Como funciona O fluxo ponta a ponta do produto. Tour visual Capturas reais das principais superfícies. CLI Comandos, diagnóstico e automação. Arquitetura Como o Core, Agents e Missions se organizam. Status de release A verdade autoritativa sobre o que está publicado.
Comunidade
Contribua com o Nexus
O projeto é construído em público. Documentação, testes, screenshots e código são igualmente bem-vindos.
1. Prepare o ambiente
Go 1.25+, Bun 1.3.9+, Git e Make. Depois: bun --cwd web install --frozen-lockfile && make build.
2. Abra uma issue
Antes de grandes mudanças, alinhe o escopo em uma issue ou discussion no repo.
3. Faça um branch
Ex.: feat/worktree-gates. Commits seguem Conventional Commits — o repo roda commitlint + husky.
4. Envie um PR
Describe o que mudou e como verificar. Veja o CONTRIBUTING.md para o contrato completo.
Quer começar fácil? Melhorias de docs e novos screenshots do tour visual são ótimos primeiros PRs.
FAQ
Perguntas frequentes
As respostas curtas, sem marketing.
O que é o Nexus?
Uma workstation local e control plane para coding agents: Projects, Agents persistentes, terminais supervisionados, Missions com evidência e downloads para Linux, Windows e macOS.
Por que não continuar rodando o agent do jeito que está hoje?
Para correções pequenas, faça do jeito que preferir — o modo Direct existe para isso. O Nexus entra quando o trabalho é longo, paralelo ou multi-agent: worktrees isolados, gates, quotas e conclusão por evidência — COMPLETED_VERIFIED, não um "done" declarado.
O Nexus vê meu código?
O Nexus roda na sua máquina. Workspaces, terminais, runtimes e memória são locais: ele dá status do trabalho, não coleta dados seus. Sem telemetria de terceiros.
Quais agents e providers funcionam?
Agents são identidades persistentes; Codex, Claude, Gemini e outros executores são recursos selecionáveis por capacidade e policy. Trocar de provider não troca o seu agente.
Nexus está estável?
Ainda não: os binários atuais são previews de desenvolvimento, sem certificado assinado. A trilha exata até releases estáveis está em docs/release-status.md — nada é anunciado estável sem evidência.
Quanto custa?
É open source da IAPro Community, sujeito a LICENSE e Beta Terms. Para dúvidas e acompanhamento, junte-se à comunidade no WhatsApp.
Coloque seus agents para trabalhar.
Downloads para Linux, Windows e macOS — ou explore o source no GitHub e venha construir com a comunidade.