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.
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.
- 1Crie um workspace e selecione a pasta do projeto.
- 2Abra Agentes, escolha qualquer serviço disponível e fixe até quatro favoritos se quiser acesso direto pela barra.
- 3Marque um agente como líder para habilitar a orquestração do time.
- 4Descreva o resultado desejado; o líder pode recrutar especialistas e distribuir tarefas.
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.
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"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.
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.
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.
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.
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.