M2D Maestro

Claude Code e OpenAI Codex regidos em um só chat, dentro do VS Code.

Você descreve a tarefa; o Maestro escolhe quem executa — Claude, Codex ou os dois em sequência — e mostra tudo ao vivo: o raciocínio, os comandos executados e a resposta sendo escrita. Antes de editar arquivos ou rodar comandos, os agentes pedem a sua aprovação.

O Maestro usa as CLIs claude e codex já instaladas na sua máquina, com as suas próprias contas. Não há API key obrigatória nem servidor intermediário.

Destaques

Roteamento automático — o pedido vai para quem faz melhor: Claude para arquitetura, análise e revisão; Codex para implementação, correções e testes.
Fluxo Review — Claude analisa → Codex implementa → Claude revisa. Dupla checagem para mudanças críticas, com uma única revisão final.
Aprovação de ações — cada comando e cada edição de arquivo aparecem num card com Permitir, Sempre nesta conversa ou Negar.
Tempo real — texto token a token, raciocínio, comandos com saída expansível e cronômetro.
Modelos e esforço — escolha o modelo de cada agente com os nomes e versões reais informados pelas CLIs.
Limites de uso — quanto já foi consumido nas janelas de 5 horas e semanal de cada agente, e quanto falta para reiniciar.
Memória por conversa — cada conversa retoma a sessão do Claude e do Codex; o histórico fica salvo e pode ser reaberto.
Contexto mínimo — envia só o arquivo aberto e o trecho selecionado; arquivos sensíveis como .env nunca têm o conteúdo enviado.

Requisitos


VS Code	1.90 ou superior (também funciona em Cursor, Windsurf e VSCodium via Open VSX)
Claude Code CLI	instalada e com login feito — `npm install -g @anthropic-ai/claude-code`, depois rode `claude` uma vez
Codex CLI	instalada e com login feito — `npm install -g @openai/codex`, depois rode `codex login`

Você pode usar só uma das duas CLIs; o Maestro avisa quando uma delas não é encontrada. Abra uma pasta de projeto no VS Code antes de usar.

Como usar

Abra o Maestro pelo botão Maestro na barra de status, pela paleta de comandos (M2D Maestro: Abrir M2D Maestro) ou com Ctrl+Alt+M (⌃⌘M no Mac).
Escreva o pedido e pressione Enter.
Acompanhe a resposta ao vivo e aprove as ações quando o agente pedir.

O botão ? no topo do painel abre um guia completo de como tudo funciona.

Quem executa cada mensagem

Opção	O que faz
Auto	O regente lê o pedido e escolhe o agente
Claude ou `/claude`	Força o Claude Code
Codex ou `/codex`	Força o Codex
Review ou `/review`	Claude analisa → Codex implementa → Claude revisa (cerca de 3× o custo)
`/status`	Mostra workspace, modo e as CLIs encontradas

O regente do modo Auto pode ser: regras locais (instantâneo, sem custo), o Claude ou o Codex decidindo.

Permissões

O botão com o escudo, ao lado do campo de mensagem, define o que os agentes podem fazer sem perguntar:

Nível	Comportamento
Perguntar (padrão)	Leem o projeto à vontade; pedem aprovação antes de editar arquivos ou executar comandos
Editar sozinho	Edições dentro do projeto passam direto; comandos ainda pedem aprovação
Somente leitura	Só leem e analisam; qualquer alteração é recusada
Acesso total	Sem confirmações — o Codex inclusive fora do projeto e com rede. Use apenas em projetos em que você confia

Configurações

Configuração	Padrão	Descrição
`m2dMaestro.permissions`	`perguntar`	O que os agentes podem fazer sem aprovação
`m2dMaestro.mode`	`normal`	`economico` (sempre um agente), `normal` ou `critico` (libera o Review com mais facilidade)
`m2dMaestro.orchestrator`	`heuristico`	Quem decide o agente no modo Auto: `heuristico`, `claude` ou `codex`
`m2dMaestro.defaultAgent`	`auto`	Agente usado quando nenhum é escolhido
`m2dMaestro.claudeModel` / `claudeEffort`	padrão da CLI	Modelo e esforço do Claude
`m2dMaestro.codexModel` / `codexEffort`	padrão da CLI	Modelo e esforço do Codex
`m2dMaestro.showRoutingInfo`	`true`	Mostra quem decidiu o roteamento em cada resposta

Tudo isso também pode ser ajustado direto no painel, pelo botão de afinação e pelo escudo.

Privacidade e dados

Os pedidos vão direto da sua máquina para a Anthropic e a OpenAI pelas CLIs oficiais, usando as suas contas. O Maestro não tem servidor próprio nem coleta dados.
O histórico das conversas fica salvo em .maestro/ dentro do projeto aberto. Recomendamos adicionar essa pasta ao .gitignore.
API keys opcionais (usadas só como alternativa ao login das CLIs) ficam no armazenamento seguro do VS Code, que usa o keychain do sistema.
O uso consome os limites e créditos das suas contas Claude e OpenAI normalmente.

Limitações conhecidas

A aprovação do Codex usa o codex app-server, que a própria CLI ainda marca como experimental.
A descoberta de modelos depende da versão instalada das CLIs; versões muito antigas podem não listar os modelos.
Uma resposta por vez em cada painel.

Licença

MIT — o texto completo acompanha a extensão no arquivo LICENSE.