Guia geral do Dev Command Center

Use o DCC como centro de comando local para agentes e terminais

O fluxo principal é simples: escolha um projeto, crie um workspace para a tarefa, abra terminais e agentes lado a lado, revise as mudanças e decida o que entra no código. A IA sugere; você aprova.

01

Projeto

Escolha um repositório Git local para o DCC acompanhar.

~/projetos/minha-api
02

Workspace

Crie uma área de trabalho para uma tarefa, branch ou review específico.

feat/checkout-stripe
03

Panes

Abra terminal, Claude, Gemini, Codex ou Cursor lado a lado no workspace.

Terminal + Claude + Gemini
04

Atenção

Acompanhe quando um agente terminou, precisa de você ou gerou mudanças para revisar.

toast + sidebar + histórico local

Primeiro uso

Como começar sem se perder

Pense no DCC como um workbench: cada tarefa deve nascer dentro de um workspace explícito. Isso evita trocas de branch desnecessárias, reduz troca de contexto e deixa cada agente trabalhando no lugar certo.

Baixe o desktop pelo GitHub Releases.

Abra o app e registre um repositório Git local.

Crie um workspace novo para a tarefa atual.

Abra Panes de terminal e agente conforme a necessidade.

Revise diffs, rode testes e faça commit no seu ritmo.

Exemplo mental do fluxo

1. Abra o projeto
2. Crie um workspace para a tarefa
3. Abra um terminal para rodar o app
4. Abra um agente para implementar
5. Abra outro agente para revisar/testar
6. Revise, teste e faça commit

Workbench

Superfícies que você usa durante a tarefa

O DCC junta revisão, código, terminal, plano e agentes no mesmo fluxo. A ideia é simples: encontre o contexto certo, selecione o que importa e envie para o agente quando precisar de ajuda.

Inspector

Use para revisar a árvore de arquivos alterados, abrir diffs e decidir o que precisa de atenção antes de aplicar ou commitar.

  1. 1Abra Inspector → Changes no workspace.
  2. 2Clique em um arquivo para ver o diff.
  3. 3Selecione um trecho, arquivo ou achado relevante.
  4. 4Envie para o Composer ou para um agente com o contexto da seleção.

Dock de código

Use como mini editor dentro do DCC para ler, ajustar e separar trechos de código sem sair do workbench.

  1. 1Abra o arquivo no dock de código.
  2. 2Selecione uma função, trecho ou bloco problemático.
  3. 3Envie a seleção para o agente explicar, refatorar ou criar testes.
  4. 4Volte ao Inspector para conferir o diff depois da mudança.

Terminais

Use terminais para comandos que você quer controlar diretamente: dev server, testes, lint, migrações, Git e diagnóstico.

  1. 1Abra um Pane de terminal no workspace.
  2. 2Rode comandos no mesmo contexto da tarefa.
  3. 3Mantenha logs visíveis enquanto agentes trabalham.
  4. 4Use a saída do terminal como contexto para o Composer quando precisar.

Composer e Plan

Use o Composer para conversar com o agente e o modo Plan quando quiser alinhar estratégia antes de mudar código.

  1. 1Descreva o objetivo no Composer.
  2. 2Peça um plano antes da implementação.
  3. 3Revise etapas, riscos e arquivos prováveis.
  4. 4Aprove o caminho e só então siga para implementação.

Spec

Use specs para transformar uma tarefa ambígua em uma definição clara de objetivo, escopo, critérios e verificação.

  1. 1Crie ou abra uma spec no workspace.
  2. 2Registre objetivo, fora de escopo e critérios de aceite.
  3. 3Use a spec como contexto para agentes.
  4. 4Atualize a spec quando a decisão de produto ou engenharia mudar.

Abrir na IDE favorita

Use quando precisar de uma edição maior no editor que você já usa, mantendo o DCC como centro de coordenação.

  1. 1Escolha sua IDE preferida nas configurações quando aplicável.
  2. 2Abra o workspace em Cursor, Zed ou VS Code.
  3. 3Edite no editor e acompanhe mudanças no Inspector.
  4. 4Volte ao DCC para revisar, delegar, testar e commitar.

Provider handoff

Continue a mesma tarefa com outro provider

Não existe um comando separado de transferência. Em uma sessão que já tem histórico, selecione outro provider no Composer e envie a próxima mensagem normalmente. O DCC detecta a troca e anexa um reanchor limitado uma única vez.

Fluxo direto

  1. 1Trabalhe normalmente em uma tarefa existente.
  2. 2Selecione outro provider; o DCC avisa que o contexto limitado seguirá no próximo turno.
  3. 3Escreva e envie a próxima mensagem como sempre.
  4. 4O novo runtime recebe o reanchor; os turnos seguintes com ele voltam ao fluxo normal.

O que acompanha a troca

Workspace, caminho e branch atuais.

Resumo limitado do estado Git.

Spec de missão e plano ativo, quando existirem.

Mensagens recentes concluídas do usuário e do agente.

É um reanchor determinístico e limitado, não memória nativa 1:1 entre providers. Transcript completo, raciocínio oculto, ruído de ferramentas e patches Git brutos não são enviados. Uma nova tarefa ou thread começa limpa.

Quer continuar a mesma tarefa?

Use provider handoff: mesma sessão, mesma timeline e mesmo worktree. Apenas selecione o novo provider e envie.

Quer separar, comparar ou revisar antes de aplicar?

Use delegation: uma sessão filha recebe um objetivo próprio e, para implementação, trabalha em uma worktree isolada que você pode aplicar ou descartar.

Delegação

O que delegar e como executar

Terminal

Comandos determinísticos, logs, testes, build e Git.

yarn testnpm run lintgit diff --statgit status --short

Agente CLI

Tarefas de código em linguagem natural, sempre dentro do workspace aberto.

claudegeminicodex

Provider no DCC

Runtime/provider escolhido no workbench para sessões, Panes e delegações compatíveis.

ClaudeGeminiCodexCursor

Hotfix sem perder contexto

  1. 1Crie um workspace temporário a partir da branch de produção.
  2. 2Abra um Pane de terminal para reproduzir o bug.
  3. 3Delegue para um agente investigar a causa e sugerir patch pequeno.
  4. 4Rode testes no terminal, revise o diff e faça commit apenas quando estiver satisfeito.

Prompt exemplo

Investigue a falha de login neste workspace. Proponha o menor patch possível, explique o risco e aguarde minha revisão antes de ampliar o escopo.

Refatoração com testes em paralelo

  1. 1Abra um workspace para a refatoração.
  2. 2Use um Pane com Claude/Codex para alterar a arquitetura.
  3. 3Use outro Pane com Gemini para criar testes e casos de borda.
  4. 4Use o terminal para rodar test suite, lint e inspecionar o diff final.

Prompt exemplo

Refatore este módulo mantendo o contrato público. Liste arquivos alterados, riscos e comandos de verificação. Não mude comportamento fora do escopo.

Review de PR local

  1. 1Crie um workspace a partir da branch do PR.
  2. 2Abra terminal para instalar/rodar o projeto sem tocar no seu setup principal.
  3. 3Delegue para um agente revisar regressão, testes ausentes e legibilidade.
  4. 4Valide manualmente e feche o workspace ao terminar.

Prompt exemplo

Revise esta branch como code review. Priorize bugs, regressão, risco operacional e testes faltando. Responda com achados por severidade.

Delegar um plano para outro modelo executar

O fluxo mais seguro para mudanças maiores é separar planejamento de execução. Use um modelo na sessão principal para planejar em Plan mode, aprove o caminho, depois delegue a implementação para outro modelo em uma worktree isolada.

A sessão principal continua sendo o lugar de decisão.

O modelo executor recebe o plano completo e o contexto necessário.

A implementação aparece como diff revisável no Inspector.

Você aplica, pede ajuste ou descarta sem misturar trabalho incompleto.

Formato enviado ao executor

Implement the plan below using the current workspace.

<plano completo capturado pelo Plan mode>

Execution criteria:
- Keep the implementation scoped to this plan.
- Preserve the planner's frontend/design decisions.
- Use the repository's existing patterns and available project skills/instructions.
- Run focused validation where practical and report the exact commands/results.
- End with a concise summary of changed files, decisions, and validation.

Planejar com um modelo, implementar com outro

Use quando você quer que um modelo pense a estratégia, UX ou arquitetura antes de outro modelo tocar no código.

Prompt para o planejador

Planeje uma melhoria compacta para a tela de documentação. Foque em clareza para usuário final, ordem das seções e exemplos práticos. Não implemente ainda.

  1. 1Abra a conversa com o modelo planejador.
  2. 2Ative Plan mode antes de enviar o pedido.
  3. 3Revise o plano retornado e ajuste o escopo se necessário.
  4. 4Clique em Delegate plan.
  5. 5Mantenha Implement e Full reanchor para o executor receber plano, contexto e diff.
  6. 6Envie para o provider de implementação, por exemplo Codex.
  7. 7Revise o diff no Inspector antes de aplicar.

Linha opcional para o executor

Preserve as decisões do plano. Rode a validação mais focada possível e termine com arquivos alterados, decisões e resultado dos comandos.

Transformar investigação em correção isolada

Use quando o planejador já encontrou a causa provável de um bug e você quer testar a solução sem sujar o workspace principal.

Prompt para o planejador

Investigue por que o banner de plano continua aparecendo depois que a tarefa já foi delegada. Retorne um plano curto com arquivos prováveis, risco e validação. Não edite arquivos.

  1. 1Leia o plano e confirme se a causa faz sentido.
  2. 2Clique em Delegate plan para abrir a delegação preenchida.
  3. 3Adicione uma restrição de teste se ela não estiver no plano.
  4. 4Execute a delegação em Implement.
  5. 5Use o Inspector para revisar arquivos alterados e diff.
  6. 6Se estiver quase certo, envie feedback para a sessão filha corrigir.
  7. 7Aplique apenas quando o resultado estiver pronto.

Linha opcional para o executor

Inclua ou atualize testes focados para o estado que esconde o banner depois da delegação.

Spec vira plano, plano vira implementação

Use quando a tarefa tem critérios de aceite e você quer manter a trilha Spec → Plan → Implementação revisável.

Prompt para o planejador

Gere um plano a partir desta spec. Cubra explicitamente os critérios AC-1, AC-2 e AC-3. Não implemente ainda.

  1. 1Crie ou abra a spec da tarefa.
  2. 2Use Generate plan para pedir o plano em Plan mode.
  3. 3Confira se os passos citam os critérios de aceite.
  4. 4Clique em Delegate plan.
  5. 5Mantenha Full reanchor para levar spec, plano e resumo da sessão.
  6. 6Revise a implementação contra os critérios no Inspector.
  7. 7Aplique ou descarte a worktree isolada.

Linha opcional para o executor

No resumo final, diga quais critérios foram cobertos e quais comandos validaram a entrega.

Full reanchor

Melhor para Delegate plan. Envia resumo da sessão, spec, plano e diff para o executor continuar da intenção aprovada.

Review current diff

Melhor para uma segunda opinião sobre as mudanças atuais, sem pedir implementação nova.

Minimal

Melhor para perguntas pequenas quando contexto demais pode atrapalhar a resposta.

O que você controla em uma delegação

Você escolhe o provider e o tipo de tarefa: Review, Explain ou Implement.

Review gera uma segunda opinião sobre o trabalho.

Explain investiga e explica uma área do código.

Implement cria uma proposta de mudança para revisar.

O Inspector mostra arquivos alterados e diffs antes de aplicar.

Você pode enviar feedback para o agente melhorar a proposta.

Você aplica o resultado quando estiver satisfeito.

Você descarta a delegação quando não quiser usar o resultado.

Skills do DCC

Reutilizar instruções em vários agentes

Skills são instruções reutilizáveis para o DCC orientar agentes em tarefas comuns do seu projeto. Em vez de repetir o mesmo prompt toda vez, você cria uma skill, escolhe os agentes que devem usá-la e segue trabalhando.

Um lugar para padrões do time

Crie skills para tarefas repetidas como revisar PR, escrever testes, investigar bugs, preparar release ou documentar uma mudança.

Disponível nos agentes

Depois de salvar, o DCC deixa a skill disponível para os agentes escolhidos. Você não precisa reescrever o mesmo prompt em cada ferramenta.

Controle de uso

Escolha quais agentes recebem a skill e desative a invocação automática quando quiser usar aquela instrução apenas como referência manual.

Exemplos de skills úteis

revisar-pr

Revisar mudanças por risco, regressão e testes faltando.

criar-testes

Gerar testes para a feature atual seguindo padrões do repo.

investigar-bug

Ler logs, mapear causa provável e propor menor correção.

documentar-feature

Atualizar README, docs de uso e exemplos da mudança.

Claude

Bom para refatoração, explicação e implementação orientada por contexto.

Selecione Claude quando a skill deve orientar sessões do Claude no DCC.

Codex

Bom para engenharia de código, revisão, testes e manutenção de repos.

Selecione Codex quando a skill deve orientar sessões Codex abertas pelo DCC.

Gemini

Bom para análise ampla, geração de testes e leitura de contexto longo.

Selecione Gemini quando a skill deve orientar sessões Gemini no workspace.

Cursor

Bom para manter regras do projeto alinhadas com o editor.

Selecione Cursor quando a skill deve acompanhar o fluxo de edição no Cursor.

Fluxo dentro do app

  1. 1Abra um projeto/workspace no DCC.
  2. 2Abra Skills pelo workbench.
  3. 3Crie uma skill com nome, descrição e instruções.
  4. 4Selecione os agentes que devem receber aquela skill.
  5. 5Salve a skill.
  6. 6Abra um Pane do agente escolhido e use a skill no fluxo de trabalho.

Exemplo de instrução

Nome: revisar-pr
Descrição: revisar uma branch antes de abrir ou atualizar PR

Instrução:
- Priorize bugs, regressão e testes ausentes.
- Cite arquivo e linha quando possível.
- Sugira correções, mas aguarde minha aprovação.
- No final, liste comandos de verificação.

Credenciais

Preparar GitHub, GitLab e providers para o DCC

Para o DCC usar GitHub, GitLab, CodeRabbit, Codex, Claude, Gemini ou Cursor, faça login nas ferramentas correspondentes no computador onde o app está instalado. Depois abra o DCC e selecione o projeto normalmente.

GitHub

Faça login no GitHub CLI para o DCC conseguir abrir, consultar e preparar PRs de repositórios GitHub.

GitHub setup

brew install gh
gh auth login
gh auth status
gh auth setup-git
gh repo clone owner/repo
Docs oficiais

GitLab

Faça login no GitLab CLI para o DCC trabalhar com projetos GitLab, incluindo instâncias self-managed.

GitLab setup

brew install glab
glab auth login
glab auth status
glab auth login --hostname gitlab.example.com
glab repo clone group/project
Docs oficiais

Codex / OpenAI

Faça login no Codex antes de abrir um Pane Codex no DCC. Use device auth quando estiver em ambiente sem navegador.

Codex / OpenAI setup

codex login
codex login --device-auth
codex
codex --help
ls ~/.codex
Docs oficiais

CodeRabbit

Em Settings > Account, conecte a CLI do CodeRabbit. Depois rode reviews em Inspector > Changes e escolha quais achados enviar para o Composer.

GitHub ou GitLab

Quando o projeto tiver remoto GitHub ou GitLab, o DCC mostra contexto de PR/MR e usa a conta autenticada na CLI correspondente.

Providers

Claude, Gemini, Codex e Cursor precisam estar instalados e autenticados no computador. O DCC abre esses agentes no workspace selecionado.

Checagens úteis

export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."
claude doctor
gemini --version
codex --version

Acesso móvel

Parear o celular com o Desktop

O acesso móvel serve para acompanhar o workbench quando você não está na frente da tela principal. Pareie o celular pelo QR e use o painel móvel para ver agentes em execução e itens que precisam da sua atenção.

  1. 1No Desktop, abra Settings → Connections → Pair new device.
  2. 2Escolha LAN se o celular estiver na mesma rede ou Tailscale se estiver usando rede privada.
  3. 3Escaneie o QR com o celular.
  4. 4Digite o PIN de 6 dígitos exibido no Desktop antes que ele expire.
  5. 5Depois de pareado, acompanhe panes, agentes em execução e itens que precisam da sua atenção.

Boas práticas

Use rede confiável

Prefira sua rede de casa, escritório ou Tailscale. Evite Wi-Fi público para parear.

Ative notificações

Use o mobile para perceber quando um agente terminou ou está aguardando resposta.

Revogue quando necessário

Se trocar de aparelho ou perder o celular, remova o dispositivo pareado em Settings.

Rede

Opções para conectar o mobile

Mesma rede Wi-Fi

Use quando desktop e celular estão no mesmo Wi-Fi. É a opção mais simples para casa ou escritório confiável.

Tailscale

Use quando quiser conectar celular e desktop mesmo fora da mesma rede, mantendo ambos na sua tailnet.

Link seguro

Se o navegador bloquear o pareamento por segurança, use o link recomendado pelo DCC ou conecte pelo Tailscale.

Linux

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale status
tailscale ip -4

macOS com Homebrew

brew install --cask tailscale
open -a Tailscale
tailscale status
tailscale ip -4

iPhone ou Android

Instale Tailscale pela App Store ou Google Play, entre na mesma conta/tailnet do Desktop e confirme que o dispositivo aparece em `tailscale status` no computador.

Fluxo no DCC

Com Tailscale ativo no desktop e no celular, abra Settings → Connections → Pair new device, escolha o endpoint Tailscale e escaneie o QR pelo celular.

Links úteis: downloads do Tailscale, instalação Linux.

Leitura complementar

Documentos do produto