Orquestra · 2026-07-12

Workspaces no Orquestra: Organizando Projetos por Contexto

Aprenda a usar workspaces no Orquestra para organizar seus projetos de desenvolvimento com agentes de IA. Contextos isolados, layouts persistentes e produtividade multipla.

Se voce trabalha com multiplos projetos simultaneamente -- um sistema Django aqui, uma API Node.js acola, um script de automacao mais adiante -- sabe o desafio de manter o contexto organizado. Cada projeto tem seus proprios agentes, terminais, variaveis de ambiente e fluxos de trabalho. Os workspaces do Orquestra resolvem esse problema: cada projeto ganha seu proprio canvas, com tudo salvo exatamente como voce deixou.

O que sao workspaces no Orquestra?

Um workspace no Orquestra e como um "projeto" dentro da ferramenta. Ele armazena:

  • Layout do canvas: Posicao e tamanho de cada terminal, blocos de anotacao e regioes visuais.
  • Agentes conectados: Quais agentes estao ativos, em qual diretorio estao trabalhando e o historico de comandos.
  • Configuracoes do projeto: Diretorio raiz, variaveis de ambiente, preferencias de terminal e atalhos customizados.
  • Estado dos terminais: Sessoes ativas, diretorio corrente e output recente de cada terminal.

Na pratica, criar um workspace e como ter uma mesa de trabalho dedicada para cada projeto. Voce nao precisa desmontar uma mesa para comecar a trabalhar em outra.

Criando e gerenciando workspaces

Criar um novo workspace no Orquestra e simples. Veja o passo a passo:

  • 1. Novo workspace:Clique em "Workspaces" no menu superior e selecione "Novo Workspace" (ou Ctrl+Shift+N).
  • 2. Nomeie o workspace:Use um nome descritivo como "API-Pagamentos" ou "Frontend-Admin". O nome aparece no seletor de workspaces.
  • 3. Configure o diretorio: Aponte para a pasta raiz do projeto. Todos os terminais abertos neste workspace iniciarao neste diretorio.
  • 4. Adicione agentes: Abra os terminais dos agentes que voce precisa (Claude Code, Codex, OpenCode) e posicione-os no canvas.
  • 5. Salve o layout: O Orquestra salva automaticamente. Voce pode fechar e reabrir quando quiser.

Dica:Use workspaces tematicos. Por exemplo, "Implementacao" para codigo novo, "Refatoracao" para melhorias, e "Review" para revisoes de codigo. Cada um com seus agentes e layout especifico.

Alternando entre workspaces

A alternancia entre workspaces e instantanea. O Orquestra mantem todos os workspaces abertos em segundo plano, entao voce pode trocar de contexto sem perder o estado de nenhum agente.

Existem tres formas de alternar:

  • Seletor visual: Clique no nome do workspace no topo da janela para abrir o seletor com todos os workspaces.
  • Atalho de teclado: Ctrl+Tab alterna entre os dois ultimos workspaces usados. Ctrl+Shift+Tab abre o seletor completo.
  • Busca: Ctrl+P abre a paleta de comandos onde voce pode digitar o nome do workspace e pressionar Enter para alternar.

Workspaces para trabalho em equipe

Workspaces no Orquestra sao portateis. Cada workspace e armazenado em um arquivo JSON dentro do diretorio do projeto (.orquestra/workspace.json). Isso significa que voce pode:

  • Versionar no Git: Inclua o arquivo de workspace no repositorio para que toda a equipe tenha o mesmo setup.
  • Compartilhar layouts: Um membro da equipe pode criar um workspace otimizado e compartilhar com os demais via Git.
  • Manter consistencia:Todos usam a mesma configuracao de agentes e terminais, eliminando o "funciona na minha maquina".
.orquestra/ workspace.json # Configuracao do workspace agents/ # Cache local dos agentes history/ # Historico de comandos

Boas praticas com workspaces

Para tirar o maximo proveito dos workspaces, algumas recomendacoes:

  • Um workspace por projeto: Evite misturar contextos. Cada workspace deve corresponder a um projeto ou micro-servico.
  • Nomes descritivos:Prefira "API-Catalogo" em vez de "Projeto1". Facilita a identificacao rapida.
  • Limpeza periodica: Workspaces nao utilizados ocupam espaco mental. Exclua workspaces de projetos concluidos.
  • Use workspaces temporarios: Crie workspaces descartaveis para experimentos e prototipos sem poluir o ambiente principal.

Organize seus projetos com workspaces

Baixe o Orquestra gratis por 7 dias e crie workspaces dedicados para cada projeto no Windows 11.