Saltar para o conteúdo principal
O Orkestral é um app de desktop local-first onde um time de agentes de IA trabalha no seu código com contexto completo. Antes de começar a clicar por aí, ajuda ter o modelo mental certo. Esta página é o mapa conceitual de todo o produto: seis ideias que se encaixam, mais um link para a página dedicada de cada uma. A visão geral em uma frase: você dá a um workspace algumas fontes (seus repositórios), um time de agentes planeja o trabalho e o transforma em issues, o Forge local executa as mudanças de código, e tudo o que o time aprende flui para a base de conhecimento.

​
O modelo mental em um relance

Workspace

A unidade de contexto. Tudo (fontes, agentes, issues, conhecimento) pertence a um workspace.

Fontes

Os repositórios e pastas que os agentes têm permissão para ler e alterar.

Time de agentes

Um orquestrador CEO mais especialistas que planejam e delegam o trabalho.

Issues e épicos

Trabalho rastreável. Pedidos viram issues, agrupadas automaticamente em épicos.

O Forge

O modelo local embutido que executa mudanças de código a $0 de custo de API.

Base de conhecimento

Um wiki vivo para cada workspace, construído a partir dos seus repositórios.

​
Como as peças se relacionam

Leia este fluxo de cima para baixo. Cada conceito alimenta o próximo.
1

Você abre um workspace

Um workspace é o contêiner para um produto ou área. Ele reúne suas fontes, seus agentes, suas issues e seu conhecimento em um só lugar.
2

Você adiciona fontes

Você aponta o workspace para os repositórios e pastas em que quer que o time trabalhe. Esse é o contexto de onde os agentes leem.
3

O agente CEO planeja

Você escreve um pedido em linguagem simples. O CEO lê as fontes, identifica a stack e decide o que precisa acontecer. Ele pode delegar para especialistas.
4

O trabalho vira issues

Pedidos relevantes viram issues, agrupadas em épicos, com status, prioridade e responsável. O produto é trabalho rastreável, não chat descartável.
5

O Forge executa

Quando mudanças de código são necessárias, um modelo premium planeja as edições e o Forge local as aplica de forma determinística na sua máquina.
6

Os aprendizados fluem para a base de conhecimento

O que o time descobre sobre o seu código é escrito de volta na base de conhecimento do workspace, para que o trabalho futuro comece mais inteligente.
Tudo roda na sua máquina. Seu código, conversas, agentes e dados permanecem locais em ~/.orkestral. Nenhum servidor é necessário e não há telemetria.

​
Workspace: a unidade de contexto

Um workspace é a fronteira para tudo o que o Orkestral faz. Quando você troca de workspace, você troca o mundo inteiro: um conjunto diferente de fontes, um time de agentes diferente, issues diferentes e uma base de conhecimento diferente. Nada vaza de um workspace para outro. Use um workspace por produto, cliente ou área principal. Cada workspace também carrega sua própria cor de destaque, para que você os diferencie num relance.

Saiba mais sobre workspaces

Como criar, trocar e organizar workspaces, e o que vive dentro de cada um.

​
Fontes: os repositórios e pastas

Fontes são os repositórios e pastas locais que você conecta a um workspace. Elas são a verdade fundamental de onde os agentes leem: conteúdo dos arquivos, status do git, diffs e histórico. Sem fontes, o time não tem contexto para planejar. Você decide quais fontes um workspace pode ver. Os agentes leem em todas elas quando planejam, e o Forge escreve as mudanças de volta nelas quando executa.

Saiba mais sobre fontes

Como adicionar repositórios e pastas, e como os agentes os usam como contexto.

​
O time de agentes: CEO mais especialistas

O Orkestral não te dá um único chatbot. Ele te dá um time com hierarquia de reporte.
  • O CEO (orquestrador) reporta a você. Ele lê o repositório, planeja e delega.
  • O Tech Lead e o Code Reviewer reportam ao CEO.
  • Os especialistas (Frontend, Backend, DevOps, QA, Designer) reportam ao Tech Lead.
Você fala com o CEO em linguagem natural. Para encaminhar um pedido direto a um especialista, mencione @agent no chat. O CEO também pode propor e contratar um time inicial para um novo workspace.
Os modelos premium fazem o planejamento, o Forge local faz a execução, e você permanece no controle. Essa divisão é o coração de como o Orkestral mantém o custo baixo sem perder qualidade.

Saiba mais sobre o time de agentes

Os papéis, a hierarquia, a contratação de um time e o encaminhamento de trabalho com @agent.

​
Issues e épicos: trabalho rastreável

Todo pedido relevante vira uma issue. Issues carregam status, prioridade, responsável e vínculos pai/filho, e são agrupadas automaticamente em épicos. A deduplicação do lado do servidor evita que você acumule duplicatas. Essa é a parte que torna o Orkestral um deck operacional em vez de uma janela de chat: o trabalho não some em um buffer de rolagem. Uma conversa pode gerar uma issue, uma issue pode rodar um agente, e o resultado é rastreado.
Uma issue é uma única unidade de trabalho. Um épico agrupa issues relacionadas para que um objetivo maior permaneça organizado. O Orkestral agrupa issues em épicos automaticamente.
Principalmente do chat. Quando você descreve um trabalho para o CEO, ele transforma o pedido em uma ou mais issues com os metadados certos.
Sim. Issues e chat compartilham o mesmo contexto de workspace, então uma issue pode rodar um agente para planejar ou executar o trabalho.

Saiba mais sobre issues e épicos

Status, prioridades, responsáveis, épicos e como pedidos viram trabalho rastreável.

​
O Forge: execução local a $0 de custo de API

O Forge é um modelo de código local embutido (Qwen2.5-Coder, rodando totalmente offline) que executa mudanças de código na sua máquina. O pipeline é construído para manter o custo de API próximo de zero sem escrever código errado.
1

Um modelo premium planeja a mudança

Ele decide quais arquivos tocar e quais edições fazer.
2

O Forge emite as edições

Rodando localmente, ele produz blocos de edição SEARCH/REPLACE para a mudança.
3

Um aplicador determinístico as escreve

As edições são aplicadas por correspondência exata, depois normalizadas em espaços em branco, depois um passo fuzzy seguro de correspondência única. Qualquer coisa ambígua é rejeitada em vez de aplicada de forma errada.
4

Escala apenas se necessário

Se as edições não puderem ser aplicadas de forma limpa, o Orkestral escala para um modelo premium uma vez como fallback. Caso contrário, a execução termina a $0 de custo de API.
O aplicador nunca adivinha. Se uma edição é ambígua, ele se recusa a escrever em vez de arriscar corromper seu arquivo. Um painel de custos mostra quantas execuções foram resolvidas localmente versus escaladas.

Saiba mais sobre o Forge

Como a execução local funciona, quando ela escala e como ler o painel de custos.

​
Base de conhecimento: o cérebro do workspace

Cada workspace tem uma base de conhecimento no estilo wiki: páginas com wikilinks e uma visão em grafo. Ela é gerada automaticamente a partir dos seus repositórios e pesquisada com uma mistura de ranqueamento lexical (BM25) e busca semântica local (embeddings no dispositivo). Nenhuma nuvem está envolvida. A base de conhecimento fecha o ciclo. Os agentes leem dela quando planejam, e os aprendizados são escritos de volta nela, de modo que cada tarefa deixa a próxima mais bem informada.

Saiba mais sobre a base de conhecimento

Páginas, wikilinks, a visão em grafo e como a busca local recupera contexto.

​
Como tudo permanece unificado

Chat, issues, status e diffs do git, code reviews e a base de conhecimento vivem todos no mesmo workspace e se alimentam mutuamente. Os agentes leem em todos eles. É por isso que uma única conversa pode planejar trabalho, abrir issues, rodar o Forge, revisar o resultado e escrever o que aprendeu de volta no cérebro, sem que você precise costurar ferramentas.

​
O que fazer a seguir

Configure seu primeiro workspace

Crie um workspace e faça dele a casa do seu projeto.

Conecte suas fontes

Adicione os repositórios e pastas em que os agentes vão trabalhar.

Conheça o time de agentes

Contrate um time e aprenda a encaminhar trabalho com @agent.

Veja o Forge em ação

Assista à execução local aplicando mudanças reais de código a $0 de custo.