Orquestra is a local tool that orchestrates a team of AI coding agents (Claude Code, Codex) in isolated git worktrees with deterministic safety barriers and human-approved merges.

Stars

3

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-30

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It enforces security through filesystem isolation and a PreToolUse command firewall rather than relying on model behavior, and keeps all integration decisions human-gated.

Who it is for

  • Developers using Claude Code or Codex CLI
  • Software teams wanting safe multi-agent workflows
  • macOS power users who prefer native apps
  • Engineers seeking token-efficient agent supervision

Use cases

  • Run parallel builder and reviewer agents on the same codebase without cross-contamination
  • Implement features with a plan-before-execute flow to reduce wasted tokens
  • Audit code changes via diff inspection and manual merge approval
  • Track token usage and model cost across a multi-agent session

Strengths

  • Filesystem isolation via separate git worktrees and branches
  • Deterministic command firewall that runs before any agent action
  • Human-gated integration with explicit name-typing for merges
  • Live token monitoring and per-agent model selection for cost control

Considerations

  • Native macOS app only; Linux and Windows (WSL2) get CLI only
  • Relies on third-party agent CLIs (Claude Code, Codex) being installed and logged in
  • No automated merge or CI integration currently supported
  • Windows users must install inside WSL2; native Windows app not available

README quick start

Orquestra

Rode um time de agentes de IA na sua máquina — isolados, supervisionados e seguros por construção.

Instalação · Por que · Uso · Segurança · Arquitetura


O Orquestra transforma sua máquina em um time de engenharia de IA supervisionado. Um agente maestro recebe suas instruções em linguagem natural e recruta agentes trabalhadores — cada um trancado dentro do próprio git worktree e da própria branch, vigiado por um firewall determinístico de comandos, e integrado de volta apenas com a sua aprovação explícita, digitada.

Sem ficar copiando e colando entre terminais. Sem nenhum agente encostando na sua branch principal. Sem momentos "ops".

                    ┌─────────────┐
                    │   MAESTRO   │  ← você fala com ele em linguagem natural
                    └──────┬──────┘
             ┌─────────────┼─────────────┐
        ┌────┴────┐   ┌────┴────┐   ┌────┴────┐
        │ builder │   │reviewer │   │  docs   │  ← cada um no seu worktree,
        └─────────┘   └─────────┘   └─────────┘     branch agent/
                 notas compartilhadas = protocolo de progresso

Por que Orquestra

Rodar 3–4 agentes de IA em terminais soltos transforma você num roteador de copy-paste. O Orquestra resolve isso com três decisões de arquitetura:

DecisãoResultado
🗂O isolamento mora no sistema de arquivos, não no promptCada agente só enxerga o próprio worktree. Um agente confuso não consegue quebrar o trabalho de outro — nem a sua branch principal.
🛡Barreiras determinísticasUm hook PreToolUse bloqueia comandos destrutivos antes que eles rodem. Não depende do modelo estar num dia bom.
✍️Integrar é decisão humanaO nvo done mostra o diff completo e exige que você digite o nome do agente. Não existe merge automático. Nunca.

Recursos

  • App nativo para macOS — canvas visual com o maestro no topo e os cards dos agentes conectados abaixo dele. Status, saída do terminal, notas e diffs num relance.
  • Funciona com Claude Code e Codex — escolha o harness por agente. Times mistos (builder no Claude + reviewer no Codex) funcionam de imediato.
  • Instalação sem credenciais — o instalador detecta o que você já tem. Claude/Codex já logados? Git já configurado? O Orquestra simplesmente aproveita.
  • Pronto para GitHub — abra uma p

Related repositories

Similar projects matched by category, topics, and programming language.

Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985
uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941
simonw
Featured
simonw GitHub avatar

speech-analyzer-cli

A macOS command-line tool that uses Apple's on-device speech APIs to transcribe prerecorded audio into plain text, JSON, JSONL, SRT, or WebVTT.

Developer ToolsCLI & Terminal
20