Saltar para o conteúdo principal
Um workspace é a unidade de contexto do Orkestral. Ele reúne suas fontes, seus agentes, suas issues e sua base de conhecimento em um só lugar. Tudo fica delimitado ao workspace e armazenado localmente em ~/.orkestral.

​
O que é um workspace

Pense no workspace como o “projeto” no qual o time de IA trabalha. Quando você dá uma direção, os agentes leem as fontes daquele workspace, planejam e executam dentro daquele contexto, nada vaza de um workspace para outro.

Fontes

Os repositórios e pastas que o time lê para ter contexto completo.

Time de agentes

O CEO orquestrador e os especialistas que planejam e delegam.

Issues

Cada direção vira trabalho rastreável: issues, mudanças e revisões.

Base de conhecimento

O conhecimento acumulado do projeto, reutilizado pelos agentes.
Tudo é local. Não há servidor, telemetria ou sincronização na nuvem, o workspace vive na sua máquina, em ~/.orkestral.

​
Por que workspaces existem

Você raramente trabalha em uma coisa só. Workspaces separam contextos para que cada projeto tenha suas próprias fontes, seu próprio time e seu próprio histórico.

Contexto isolado

Os agentes só enxergam as fontes do workspace ativo.

Histórico próprio

Issues, mudanças e revisões ficam organizadas por projeto.

Identidade visual

Cada workspace pode ter sua própria cor de destaque.

​
Criar um workspace

1

Abra o seletor de workspaces

Clique no nome do workspace no topo da barra lateral para abrir o seletor.
2

Clique em Novo workspace

Selecione Novo workspace para iniciar a criação.
3

Dê um nome e escolha a cor

Defina um nome claro e escolha a cor de destaque que identifica o workspace na interface.
4

Adicione fontes

Conecte os repositórios e pastas do projeto. Veja Fontes para os detalhes.
Use a cor de destaque para diferenciar workspaces de relance, por exemplo, azul para o backend e verde para o app mobile.

​
Alternar entre workspaces

O workspace ativo aparece no topo da barra lateral. Para trocar, clique nele e escolha outro na lista.
1

Abra o seletor

Clique no nome do workspace ativo na barra lateral.
2

Escolha o workspace

Selecione o workspace desejado. A interface assume a cor de destaque dele.
Ao alternar, fontes, agentes, issues e conhecimento mudam junto. Confirme que o workspace certo está ativo antes de dar uma direção ao time.

​
O que vive dentro de um workspace

Os repositórios e pastas locais que o time lê. São a base de contexto de tudo. Veja Fontes.
O time hierárquico, CEO orquestrador, Tech Lead, Code Reviewer, Frontend, Backend, DevOps, QA e Designer. Veja Time de agentes.
Cada pedido vira trabalho rastreável, com mudanças de código e revisões associadas.
O conhecimento que o projeto acumula e que os agentes reutilizam nas próximas tarefas.
A identidade visual do workspace, aplicada na interface quando ele está ativo.
Todos esses dados são gravados localmente em ~/.orkestral, separados por workspace, gratuito e sem custo de API para os planos locais.