Pular para o conteúdo
Voltar ao início

Documentação do produto

Comece com um agente. Termine com um time.

Um guia direto para instalar o Orkestrai, montar o canvas e entregar trabalho com agentes que compartilham contexto.

01 / 09

Instalação

Baixe a versão mais recente para macOS, Windows ou Linux. O aplicativo desktop já inclui o servidor e os runtimes necessários para operar o canvas.

  • Instale ao menos uma CLI compatível: Claude Code, Codex, Kimi Code, OpenCode, Cursor, Antigravity, Cline ou Devin.
  • No macOS, use a versão 0.1.4 ou mais recente: ela é assinada com Developer ID e notarizada pela Apple, por isso abre normalmente pelo Finder depois de ser copiada para Aplicativos.
  • Mantenha o Git disponível para recursos de histórico, diff e andares.
  • Modelos locais de voz são opcionais e baixados somente após sua confirmação.
02 / 09

Primeiro workspace

Um workspace aponta para uma pasta real do seu projeto. O Orkestrai mantém a configuração visual separada e provisiona a ponte local que permite aos agentes operar o canvas.

Passo a passo
  1. 1Crie um workspace e selecione a pasta do projeto.
  2. 2Abra Agentes, escolha qualquer serviço disponível e fixe até quatro favoritos se quiser acesso direto pela barra.
  3. 3Marque um agente como líder para habilitar a orquestração do time.
  4. 4Descreva o resultado desejado; o líder pode recrutar especialistas e distribuir tarefas.
03 / 09

Canvas e conexões

O canvas reúne terminais PTY reais, notas, tarefas, fluxos, imagens, portais e arquivos. Conexões representam colaboração de verdade: quando dois agentes conversam, a aresta mostra a atividade.

  • Conecte notas e imagens aos agentes responsáveis para tornar o contexto explícito.
  • Use o kanban para atribuir trabalho; a tarefa é enviada diretamente ao terminal escolhido.
  • Abra Portais para visualizar e testar aplicações locais sem sair do workspace.
  • Use Cmd/Ctrl+K para localizar rapidamente a documentação dentro do aplicativo.
04 / 09

Líder e ponte Orkestrai

O líder coordena o time pela CLI orkestrai e pelas tools MCP provisionadas no workspace. Ele pode conversar com agentes, escrever notas, criar tarefas, abrir portais e organizar andares.

orkestrai list
orkestrai ask Frontend "Implemente a tela conforme a nota de spec"
orkestrai task add "Revisar responsividade" --assign Reviewer
orkestrai notify "Entrega pronta para revisão"
05 / 09

Workbench e editor

O Workbench transforma o mesmo workspace em uma superfície desktop focada. O explorer abre agentes, tarefas, notas, portais, dispositivos mobile e arquivos do workspace em até oito painéis redimensionáveis.

  • Escolha abas verticais ou horizontais e divida qualquer painel para a direita ou para baixo.
  • Edite arquivos no Monaco com modelos persistentes, busca e substituição, símbolos, formatação e proteção de alterações não salvas.
  • Abra Markdown, PDF, imagens e binários em prévias sem criar nodes desconectados no canvas.
  • Use Cmd/Ctrl+K para buscar arquivos, conteúdo, agentes, tarefas, ferramentas, configurações e comandos.
06 / 09

Fluxos e trabalho paralelo

Fluxos encadeiam agentes, aprovações humanas e saídas reutilizáveis. Andares usam git worktrees para isolar frentes paralelas e oferecem prévia de diff e conflitos antes de aterrissar na branch principal.

  • Sincronize um fluxo com as conexões para transformar o desenho em pipeline.
  • Veja título, etapa e responsável de cada tarefa no térreo e em cada worktree.
  • Crie um andar por feature quando equipes precisarem modificar o mesmo projeto em paralelo.
  • Revise a prévia antes de aterrissar; conflitos nunca são resolvidos silenciosamente.
07 / 09

Ditado e respostas faladas

O ditado usa Parakeet e as respostas usam Supertonic 3, ambos locais. Há presets para português do Brasil, inglês dos Estados Unidos e espanhol latino-americano.

  • Foque um campo de tarefa, role, nota ou formulário e use a bolinha global para inserir o ditado no cursor.
  • Ative o envio automático para acrescentar Enter ao ditado em terminais; campos comuns continuam apenas recebendo o texto.
  • Sem campo ativo no canvas, a bolinha envia a transcrição ao líder.
  • Escolha a voz e ajuste a velocidade entre 0,75x e 1,50x nas Configurações.
  • O primeiro download exige confirmação; depois, o processamento roda no dispositivo.
08 / 09

Operação e continuidade

Workspaces continuam trabalhando em background. Sessões retomáveis preservam cada conversa, e notificações distinguem tarefa concluída, projeto concluído e atenção.

  • Troque o provider de um agente preservando role, andar e conexões.
  • Fixe Uso no canvas e deixe o líder consultar origem, fallback, janela monitorada e limite antes de atribuir trabalho novo.
  • O painel Portas lista somente listeners vinculados aos Portais locais do workspace.
  • Escolha um tema claro ou escuro pronto, ou edite e compartilhe tokens semânticos validados.
  • Os dados do canvas, sessões e modelos locais permanecem na sua máquina.
09 / 09

Decisões, automação, dispositivos e compartilhamento

A Central de Controle e a Central de Revisão tornam atividade e evidências explícitas. Council, Automações, Dispositivo mobile e compartilhamento criptografado seguem o mesmo modelo operacional rastreável.

  • Peça perspectivas independentes a dois a cinco agentes no Council e mantenha a seleção final humana.
  • Execute automações idempotentes por agenda, tarefas, mensagens, eventos Git, webhooks, arquivos ou limites de uso.
  • Controle o iOS Simulator e emuladores Android ou aparelhos físicos aprovados pelo Canvas e Workbench.
  • Escolha um convite para navegador/celular ou app instalado, aprove o dispositivo e a função exatos e acompanhe a projeção sanitizada no PWA Remote instalável.
  • Operadores podem conversar com um agente de forma rastreável. Administradores também podem iniciar ou restaurar agentes; o terminal bruto exige uma permissão separada por dispositivo, desativada por padrão e auditada.