DSH Orchestrator — DSH, Codex e Claude no mesmo ambiente

O que é

Seu harness vira um centro de operações

Uma camada local e auditável que conecta o DSH a agentes interativos sem entregar o controle do Docker do host.

🧠 Três agentes, um workspace

DSH, Codex e Claude enxergam os mesmos projetos, Git e autenticações persistentes.

🧵 Sessões persistentes

Tmux mantém cada tarefa ativa mesmo quando o navegador fecha, com saída e entrada pelo painel.

🌿 Paralelismo seguro

Worktrees opcionais criam branches e diretórios isolados para reduzir colisões entre agentes.

Pré-requisitos

O mínimo para começar

O build baixa o DSH e as demais CLIs. Você só precisa do Docker e das contas que pretende usar.

Docker + Compose

Em Debian ou Ubuntu, use o instalador incluído.

./scripts/install-docker-debian.sh

Contas interativas

OpenAI, Anthropic e GitHub são autenticados pelos fluxos oficiais.

./scripts/login.sh all

OpenRouter ou Ollama

O DSH pode usar a nuvem ou um modelo local no host.

./scripts/configure-openrouter.sh

Guia de uso · passo a passo

Instale, autentique e orquestre

Os comandos abaixo são os mesmos usados pelo projeto real.

Clone o projeto

Baixe o runtime e entre na pasta.

git clone git@github.com:inematds/dsh-orchestrator.git
cd dsh-orchestrator

Execute o bootstrap

Ele gera o token, escolhe portas livres, constrói a imagem e inicia os serviços.

./scripts/bootstrap.sh

Faça os logins interativos

As credenciais ficam fora da árvore de projetos, no diretório de dados do runtime.

./scripts/login.sh codex
./scripts/login.sh claude
./scripts/login.sh github

Abra uma sessão isolada

Use o painel ou a CLI interna para iniciar um agente em worktree próprio.

./scripts/shell.sh
orch start codex --cwd /workspace/meu-repo \
  --name api --prompt "implemente os testes" --worktree

Acompanhe e converse

Liste sessões, capture a saída ou envie uma nova orientação sem perder o processo.

orch list
orch output ID --lines 500
orch send ID "rode os testes e corrija as falhas"

Exemplos

Fluxos que já estão prontos

A mesma infraestrutura pode ser operada manualmente ou pelo DSH via MCP.

🧭 DSH como coordenador

O DSH lista sessões, delega uma implementação ao Codex e acompanha a saída pelas ferramentas MCP estruturadas.

🔀 Dois agentes em paralelo

Codex trabalha na API e Claude explora a documentação, cada um em branch e worktree próprios.

Roadmap

Base pronta para crescer

O núcleo já funciona; as próximas fases podem ampliar observabilidade e governança.

AGORA

Runtime multiagente localPainel, API, CLI, MCP, tmux, worktrees, autenticação persistente e backup.

Políticas por projetoPerfis de permissão, limites de concorrência e seleção automática de agente.

FUTURO

Histórico e métricasEventos estruturados, custos, tempos e retomada orientada pelo painel.

Um só lugar para orquestrar seus agentes