Múltiplos projetos no Orquestra — Workspaces e agentes dedicados

Sumário

• O cenário real: múltiplos projetos, contextos diferentes
• Workspaces no Orquestra: isolamento sem complicação
• Agente por projeto: por que dedicar um agente faz diferença
• Compartilhamento de contexto entre projetos
• Exemplo prático: configurando 3 projetos no Orquestra
• FAQ — Perguntas frequentes
• Organize seus projetos hoje

O cenário real: múltiplos projetos Orquestra, contextos diferentes

Imagine sua semana típica. Segunda-feira você está refatorando uma API REST em Node.js. Terça-feira, adicionando uma seção no site institucional em Next.js. Quarta-feira, debugando um pipeline de dados em Python. Quinta-feira, voltando para a API porque o cliente pediu uma mudança. Cada projeto tem seu próprio conjunto de arquivos, variáveis de ambiente, convenções de código e até mesmo agentes de IA preferidos.

O problema clássico é o vazamento de contexto. Se você usa um único terminal ou canvas para tudo, o agente carrega histórico de conversas e arquivos de projetos anteriores. Isso polui as respostas, gera sugestões irrelevantes e, no pior caso, pode fazer alterações no projeto errado. Com gerenciar projetos Orquestra de forma adequada, cada contexto fica isolado e você elimina esse risco.

Além do isolamento, há a questão da performance. Cada agente de IA mantém na memória o contexto da conversa e o índice dos arquivos do projeto. Com três ou quatro projetos abertos no mesmo espaço, o consumo de RAM dispara. Workspaces independentes permitem que apenas o projeto ativo consuma recursos — os demais ficam em estado leve, sem drenar memória.

Workspaces no Orquestra: isolamento sem complicação

O workspace é a unidade fundamental de organização no Orquestra. Cada workspace contém:

• Um projeto: um diretório raiz com seu código, dependências e configurações
• Agentes dedicados: um ou mais agentes de IA configurados para aquele projeto
• Contexto isolado: histórico de conversas, índice de arquivos e variáveis de ambiente próprios
• Configurações independentes: regras de segurança, permissões de arquivo e preferências de execução

Criar um workspace é simples. No canvas do Orquestra, você pode iniciar um novo workspace apontando para o diretório do projeto, ou importar um repositório Git existente. O Orquestra detecta automaticamente o tipo de projeto (Node.js, Python, etc.) e sugere configurações iniciais.

A navegação entre workspaces é instantânea. Um painel lateral lista todos os workspaces abertos, e um clique alterna o contexto ativo. Cada workspace mantém seu próprio histórico — você pode sair de um projeto no meio de uma refatoração e retomar exatamente de onde parou dias depois.

Configurações por workspace

Cada workspace permite ajustar:

• Diretório raiz: o ponto de partida para todos os comandos do agente
• Agentes disponíveis: Claude Code, Codex, OpenCode, ou agentes personalizados por projeto
• Variáveis de ambiente: chaves de API, tokens e configurações específicas do projeto
• Regras de segurança: diretórios bloqueados, comandos proibidos, nível de permissão
• Git integration: branch padrão, hooks de pre-commit e política de commits

Agente por projeto: por que dedicar um agente faz diferença

Nem todo agente de IA é igual. Claude Code se destaca em refatoração e compreensão de código legado. Codex é mais rápido para geração de código boilerplate. OpenCode oferece flexibilidade para tarefas experimentais. Ao adotar multi-projeto agentes dedicados, você pode alocar o agente certo para cada tipo de projeto.

Na prática, a alocação funciona assim:

• Projeto web (Next.js): Claude Code para refatoração e manutenção de componentes
• API Node.js: Codex para geração rápida de endpoints e testes
• Pipeline Python: agente personalizado otimizado para scripts de dados
• Repositório legado: Claude Code com contexto estendido para entender código antigo

Cada agente mantém seu próprio contexto dentro do workspace. O Claude Code que refatora o site não tem acesso ao histórico da API — cada um opera em sua bolha de informação. Isso não só melhora a qualidade das respostas como reduz o consumo de tokens da API, já que o contexto não é poluído por conversas de outros projetos.

Como configurar agentes por workspace

No Orquestra, a configuração é feita por workspace:

1. Abra o workspace do projeto desejado
2. Acesse as configurações de agente
3. Selecione o agente principal e, se desejar, agentes secundários
4. Defina as variáveis de ambiente específicas (cada agente pode usar chaves de API diferentes)
5. Ajuste as instruções de sistema (system prompts) personalizadas para o projeto

Com essa configuração, você pode ter o Claude Code configurado com a chave da Anthropic para o projeto web, e o Codex com a chave da OpenAI para a API — tudo no mesmo Orquestra, sem conflito.

Compartilhamento de contexto entre projetos

Nem tudo são silos. Há momentos em que você precisa que a informação flua entre projetos. Por exemplo: você refatorou uma biblioteca compartilhada que é usada pelo site e pela API. A alteração na biblioteca precisa ser comunicada aos dois workspaces para que os agentes ajustem as importações e testes.

O Orquestra oferece mecanismos controlados de compartilhamento:

Context links

Links de contexto permitem que um workspace referencie arquivos ou diretórios de outro workspace sem duplicação. Você pode, por exemplo, montar a pasta shared/lib do workspace da API dentro do workspace do site. Os agentes de ambos os projetos enxergam os mesmos arquivos, mas cada um opera no seu próprio diretório de trabalho.

Exportação de decisões

Quando um agente toma uma decisão arquitetural que afeta múltiplos projetos, você pode exportar o resumo da decisão como um documento .md no workspace de origem e importá-lo nos workspaces dependentes. Isso mantém um registro rastreável sem expor o histórico completo de conversas.

Variáveis de ambiente globais

Para configurações que são transversais a todos os projetos (como tokens de deploy ou URLs de staging), o Orquestra oferece um escopo global de variáveis de ambiente. Workspaces individuais podem sobrescrever essas variáveis quando necessário, seguindo o princípio de herança.

Exemplo prático: configurando 3 projetos no Orquestra

Vamos montar um cenário real com três projetos e ver passo a passo como configurar no Orquestra.

Projeto 1: Site institucional (Next.js)

Workspace: site-institucional

Diretório: C:\Projetos\site

Agente: Claude Code

Chave API: ANTHROPIC_API_KEY (chave dedicada para o site)

Passos:

1. No Orquestra, clique em "Novo Workspace" e selecione o diretório C:\Projetos\site
2. Escolha Claude Code como agente principal
3. Configure a variável ANTHROPIC_API_KEY no escopo do workspace
4. Defina as regras de segurança: permitir apenas alterações em src/ e public/

Projeto 2: API REST (Node.js)

Workspace: api-rest

Diretório: C:\Projetos\api

Agente: Codex

Chave API: OPENAI_API_KEY (chave dedicada para a API)

Passos:

1. Crie um novo workspace apontando para C:\Projetos\api
2. Selecione Codex como agente principal
3. Configure a variável OPENAI_API_KEY no escopo do workspace
4. Adicione um context link para shared/lib do workspace do site (para manter tipagens consistentes)

Projeto 3: Scripts de automação (Python)

Workspace: automacao

Diretório: C:\Projetos\scripts

Agente: OpenCode

Chave API: OPENAI_API_KEY (reutilizada da API, mas em escopo separado)

Passos:

1. Crie um novo workspace para C:\Projetos\scripts
2. Selecione OpenCode como agente principal
3. Configure OPENAI_API_KEY em escopo global (já que é a mesma chave da API, mas o workspace pode sobrescrever)

Fluxo de trabalho no dia a dia

Com os três workspaces configurados, seu dia fica assim:

• Manhã: workspace api-rest ativo — Codex gerando novos endpoints. Você pede uma rota /users/:id/profile com validação e testes. Tudo fica no contexto da API.
• Tarde: um clique no painel e você está no workspace site-institucional. Claude Code está refatorando componentes. O contexto da API não aparece aqui.
• Fim de tarde: workspace automacao — você cria um script para sincronizar dados entre o site e a API. Com o context link ativo, o agente enxerga a estrutura da biblioteca compartilhada.

Cada transição é instantânea. O histórico de cada workspace persiste — você pode fechar o Orquestra, abrir no dia seguinte e retomar exatamente de onde parou em cada projeto.

FAQ — Perguntas frequentes

Quantos workspaces posso criar no Orquestra?

Não há limite. Você pode criar quantos workspaces precisar, um para cada projeto. O Orquestra mantém todos em estado leve quando não estão ativos, consumindo apenas o armazenamento do histórico de conversas e configurações — que é mínimo comparado ao projeto em si.

Workspaces diferentes compartilham o mesmo sistema de arquivos?

Sim e não. Cada workspace tem seu diretório raiz definido, mas você pode configurar context links para expor arquivos de um workspace em outro. Por padrão, o agente de cada workspace só enxerga e modifica arquivos dentro do seu diretório raiz. Isso evita alterações acidentais em projetos vizinhos.

Posso usar o mesmo agente em múltiplos workspaces simultaneamente?

Sim, desde que cada workspace tenha as credenciais do agente configuradas. O Orquestra gerencia as conexões independentemente — você pode ter Claude Code rodando no workspace do site e Codex rodando no workspace da API ao mesmo tempo. Cada um opera com seu próprio contexto e suas próprias chamadas de API.

O histórico de um workspace ocupa muito espaço?

O histórico de conversas é armazenado como arquivos de texto (JSON ou Markdown), que são extremamente compactos. Uma conversa de 100 interações ocupa tipicamente entre 50 KB e 200 KB. Mesmo com dezenas de workspaces e centenas de conversas, o impacto no disco é irrelevante.

É possível importar workspaces de um repositório Git?

Sim. Ao criar um novo workspace, o Orquestra permite clonar um repositório Git remoto ou apontar para um repositório já clonado localmente. O workspace detecta a branch atual e configura a integração com Git automaticamente.

Como faço para transferir um workspace para outro computador?

Exporte as configurações do workspace (diretório raiz, variáveis de ambiente, agentes configurados) como um arquivo JSON. No outro computador, importe o arquivo no Orquestra e aponte para o diretório correspondente do projeto. O histórico de conversas pode ser incluído na exportação se desejar.

Organize seus projetos hoje

Gerenciar múltiplos projetos Orquestra com workspaces e agentes dedicados não é um luxo — é uma necessidade para qualquer desenvolvedor que leva produtividade a sério. O isolamento de contexto evita erros, a alocação inteligente de agentes melhora a qualidade do código gerado, e a navegação instantânea entre projetos elimina a fricção de trocar de contexto manualmente.

Se você ainda usa um terminal único para todos os projetos, experimente criar workspaces separados. Comece com dois — um para o projeto principal e outro para um projeto secundário — e veja a diferença na clareza das respostas dos agentes e na organização do seu fluxo de trabalho.

Quer ver na prática? Baixe o Orquestra e monte seu primeiro workspace em menos de um minuto. Teste grátis por 7 dias, sem compromisso.