Saltar para o conteúdo principal
O Orkestral é local-first por design. Seus workspaces, agentes, chats, issues, base de conhecimento e modelos baixados ficam todos no seu próprio computador, dentro de uma única pasta no seu diretório home. Não existe conta do Orkestral, não existe sincronização na nuvem e não existe telemetria. Você mantém o controle dos seus dados e pode inspecionar, exportar ou apagar tudo quando quiser.
As únicas chamadas de rede que o Orkestral faz são as que você solicita: requisições de API de modelos premium (quando você configura uma chave de provedor) e downloads sob demanda do modelo local incluído e dos pacotes de voz. Seu código, seus prompts e os dados do seu projeto não são coletados pelo Orkestral.

​
Onde seus dados ficam

Tudo é armazenado sob uma única pasta raiz: ~/.orkestral (seu diretório home mais .orkestral). O app cria essa pasta na primeira execução e mantém todos os tipos de dados embaixo dela.

Banco de dados SQLite

O armazenamento principal é um único arquivo SQLite em ~/.orkestral/instances/default/db/orkestral.db. Ele guarda workspaces, agentes, sessões e mensagens de chat, issues e épicos, a base de conhecimento e eventos de trace.

Anexos

Os arquivos que você envia para comentários e decisões são copiados para ~/.orkestral/instances/default/attachments, então eles viajam junto com seus dados locais.

Artefatos de workspace

Arquivos e artefatos por workspace ficam sob ~/.orkestral/workspaces/<workspaceId>/.

Modelos locais

O modelo Forge incluído (Qwen2.5-Coder) e quaisquer pacotes de voz são baixados sob demanda para ~/.orkestral/instances/default/models e .../voice.
O banco de dados roda em modo WAL para ganhar velocidade e segurança. Você pode ver arquivos orkestral.db-wal e orkestral.db-shm ao lado do arquivo .db principal. Esse é o comportamento normal do SQLite, não uma cópia duplicada dos seus dados.

​
Sem telemetria, sem conta

O Orkestral não inclui analytics, relatório de falhas ou rastreamento de uso. Não há cadastro e nem sincronização em segundo plano. O app funciona totalmente offline para tudo, exceto três ações explícitas e iniciadas por você:
Quando um modelo premium planeja ou delega trabalho, o Orkestral chama o provedor de modelo que você configurou com a sua própria chave de API. Essa requisição vai direto para o provedor, não passa pelos servidores do Orkestral. Seu código e os dados do projeto saem da sua máquina apenas como parte do prompt que você escolheu enviar.
O Forge roda localmente e executa mudanças de código com custo de API zero, mas os pesos do modelo são baixados uma vez, sob demanda, para ~/.orkestral. Depois disso, o Forge roda offline.
Runtimes e modelos de voz opcionais são baixados sob demanda para a pasta local voice. Eles nunca são enviados para lugar nenhum.

​
Gerencie seus dados

Abra Settings e vá até o painel Data. A partir dali você pode revisar o que está armazenado, exportar um snapshot, abrir a pasta de dados, limpar o cache e rodar a limpeza. O painel restringe a maioria das contagens a um workspace, que você escolhe no topo.
1

Abra o painel Data

Vá em Settings e depois Data. No topo você vê um hero de armazenamento com o tamanho total do banco de dados e o caminho exato do seu arquivo orkestral.db.
2

Escolha um workspace para inspecionar

Use o seletor de workspace no topo do painel. As contagens de agentes, sessões de chat, mensagens e issues são atualizadas para aquele workspace. A seção da base de conhecimento mostra páginas, chunks, embeddings e eventos de trace.
Trocar o workspace aqui muda apenas o que você está inspecionando. Isso não muda o seu workspace ativo no restante do app.
3

Revise os números de armazenamento

Os tiles dão uma leitura rápida de quanto cada workspace guarda. O tamanho do banco de dados no hero reflete o arquivo .db inteiro, somando todos os workspaces.

​
Exporte seus dados

A exportação grava um único snapshot JSON dos seus dados principais em uma pasta que você escolhe. Use para backups, para migrar para outra máquina ou simplesmente para manter uma cópia que é sua.
1

Clique em Export to JSON

Na seção Maintenance do painel Data, clique em Export to JSON.
2

Escolha uma pasta de destino

Um seletor de pastas nativo se abre. Escolha qualquer diretório, ou crie um novo. Se você cancelar, nada é gravado.
3

Encontre o arquivo

O Orkestral grava um arquivo chamado orkestral-export-<date>.json na pasta que você escolheu. Um toast confirma o sucesso e mostra a contagem total de registros e o caminho do arquivo.
O snapshot é um documento JSON legível que inclui:

Workspaces e agentes

Sessões e mensagens de chat

Issues e épicos

Páginas da base de conhecimento

A exportação captura todos os workspaces, não apenas o que você está inspecionando. Ela também registra o timestamp da exportação e a versão do app, então você sempre sabe quando e de onde veio um snapshot.
A exportação JSON é um backup portátil dos seus registros principais. Ela não inclui pesos de modelos baixados, pacotes de voz, vetores brutos de embedding nem binários de anexos enviados. Guarde a exportação em um lugar seguro: ela é texto puro e pode conter prompts e conteúdo do projeto.

​
Abra a pasta de dados

Quer fazer o backup de tudo por conta própria, ou só ver o que está em disco? Clique em Open folder na seção Maintenance. O Orkestral abre ~/.orkestral/instances/default no gerenciador de arquivos do seu sistema operacional.
Para um backup manual completo, feche o Orkestral primeiro e depois copie a pasta ~/.orkestral inteira. Copiar com o app em execução pode capturar o banco de dados no meio de uma escrita.

​
Limpe o cache

A ação Clear cache limpa apenas o cache de rede e de sessão da janela do app. Ela não toca no seu banco de dados, nos seus arquivos ou nos seus modelos. Use se a UI do app se comportar de forma estranha ou se você quiser liberar uma pequena quantidade de disco usada pelo cache web.
Limpar o cache é seguro e não destrói seus dados. Isso nunca apaga workspaces, chats, issues ou conteúdo da base de conhecimento.

​
Rode a limpeza para recuperar espaço

Com o tempo, a base de conhecimento pode acumular itens que você não precisa mais. A limpeza propõe uma lista de exclusões seguras para o workspace selecionado, mostra quantos itens e aproximadamente quantos bytes cada uma libera, e só age depois que você confirma.
1

Revise as sugestões

No campo Cleanup, o Orkestral lista sugestões para o workspace selecionado. Cada card mostra um título, um resumo curto, a contagem de itens e um tamanho estimado.
2

Clique no botão de limpeza

Se houver algo a limpar, o botão fica habilitado. Clique nele para revelar um prompt de confirmação inline.
3

Confirme a exclusão

Clique em Confirm na barra vermelha de confirmação. O Orkestral aplica todas as sugestões listadas em uma única transação e depois informa quantas linhas removeu e o espaço estimado recuperado.
A limpeza mira algumas categorias bem definidas. Nenhuma delas toca em páginas fixadas.
Chunks, entradas de índice de token, itens de embedding e embeddings cuja página pai não existe mais. Puras sobras de conteúdo apagado.
Páginas que você arquivou, que não foram tocadas recentemente e que não estão fixadas. A janela padrão é mais antiga que 30 dias.
Páginas não fixadas geradas automaticamente e de memória de agente que não foram usadas recentemente. A janela padrão é mais antiga que 14 dias, e páginas usadas recentemente são mantidas.
Páginas que duplicam outra por título (ou por conteúdo, dependendo da sugestão). O Orkestral mantém a cópia mais recente e remove as demais. Páginas fixadas e arquivadas ficam intactas.
Embeddings que apontam para itens inexistentes ou que são mais antigos que a página ou o item que descrevem, para que a busca continue precisa, sem vetores mortos.
Depois da limpeza, o Orkestral faz um checkpoint do WAL do banco de dados e o otimiza, então o tamanho em disco diminui e suas estatísticas são atualizadas automaticamente.
A limpeza apaga permanentemente os itens que ela lista. Ela é restrita ao workspace que você selecionou e nunca remove páginas fixadas, mas não há como desfazer. Exporte um snapshot antes se quiser uma cópia de segurança.

​
O que fazer em seguida

Base de conhecimento

Aprenda como páginas, chunks e embeddings são criados para entender sobre o que a limpeza está agindo.

Modelos e o Forge

Veja como o modelo Forge local e os modelos de planejamento premium são configurados e armazenados.

Settings

Explore o restante dos painéis de Settings, incluindo o painel Data abordado aqui.

Primeiros passos

Novo no Orkestral? Comece pelo básico de workspaces e agentes.