Documentação · Public Beta 1
Introdução
O Compazio é um workspace visual local-first para trabalhar com coding agents. Terminais reais, Claude Code, Codex, OpenCode, notas, arquivos e Portais web vivem juntos no mesmo canvas.
Em vez de alternar entre várias janelas, você organiza o contexto do projeto visualmente e decide quais recursos cada agente pode acessar. O código, os prompts e o output dos terminais permanecem na sua máquina por padrão.
Visão geral
O que é o Compazio
O Compazio adiciona uma camada visual de organização, contexto e coordenação aos runtimes que você já usa. Ele não hospeda modelos, não possui uma IA própria e não revende tokens.
Canvas persistente
Seu workspace volta como você deixou, incluindo posição, grupos e conexões.
Processos reais
Cada agente continua visível e interativo em seu próprio terminal PTY.
Contexto explícito
As conexões mostram o que pode ser lido, compartilhado ou controlado.
Antes de começar
Requisitos
A distribuição pública atual foi validada para Windows 10 ou 11 x64.
- Um projeto ou pasta local para usar como workspace.
- Git, caso você queira usar as operações contextuais de versão.
- Claude Code, Codex ou OpenCode instalados e autenticados somente se quiser usar esses agentes. O Shell funciona como terminal local.
Comece aqui
Seu primeiro workspace
- Crie ou abra um workspace. Escolha o diretório do projeto que será a base do canvas.
- Adicione um terminal. Selecione Shell, Claude Code, Codex, OpenCode ou um comando personalizado.
- Traga o contexto. Adicione notas, arquivos, uma árvore do projeto ou um Portal web.
- Conecte os nós. As conexões concedem mensagens, contexto ou capacidades específicas.
- Trabalhe no terminal real. A TUI do provider permanece visível e você pode intervir a qualquer momento.
Recursos principais
O canvas
O canvas é a superfície principal do Compazio. Ele persiste nós, grupos, conexões, posição da viewport e zoom para que o contexto do projeto não desapareça entre sessões.
| Gesto | Resultado |
|---|---|
| Arrastar o fundo | Mover pelo canvas |
| Roda do mouse | Zoom ancorado no ponteiro |
| Shift + arrastar | Selecionar vários nós |
| Arrastar a borda do nó | Criar uma conexão |
| Clique duplo no título | Renomear o nó |
Processos locais
Terminais e agentes
Cada terminal é um PTY real com scrollback, Unicode, ANSI/truecolor, clipboard e redimensionamento. O Compazio acompanha o estado do processo sem transformar o output bruto em protocolo de conclusão.
- Shell local para comandos comuns.
- Claude Code, Codex e OpenCode usando suas instalações existentes.
- Comando personalizado quando você precisa de outro runtime.
- Parada, reinício e limpeza coordenada da árvore de processos.
Contexto explícito
Conexões
Uma conexão é uma concessão visível. Ela não injeta conteúdo nem inicia uma conversa automaticamente: só habilita as capacidades compatíveis entre os nós conectados.
| Origem → destino | Capacidade padrão |
|---|---|
| Terminal ↔ terminal | Mensagens bidirecionais e contexto compartilhado |
| Terminal → nota | Ler, substituir, acrescentar e compartilhar contexto |
| Terminal → arquivo | Contexto explícito, sem execução implícita |
| Terminal → Portal | Leitura, controle, screenshot e contexto permitido |
Materiais do projeto
Notas e arquivos
Notas Markdown são persistidas no workspace e alternam entre os modos Raw e Formatado sem mudar o texto original. Arquivos de texto, imagem, PDF e mídia podem ser importados ou soltos diretamente no canvas.
Materiais gerenciados ficam sob .compazio/ no projeto. O diretório de código escolhido por você nunca é apagado quando um workspace é excluído.
Preparação de contexto
Prompt Composer
O Prompt Composer prepara uma solicitação para um terminal existente. Ele reúne referências explícitas de notas, arquivos, árvores e outros terminais, remove duplicatas e escreve o resultado no stdin da sessão real.
Abra com Ctrl + Shift + P quando houver um terminal selecionado. O Composer não cria outro chat, agente ou histórico paralelo.
Web no canvas
Portais web
Um Portal é um navegador persistente e isolado dentro do canvas. Ele oferece navegação, voltar, avançar, atualizar, foco, captura de tela, leitura sanitizada e automação limitada por ações descritas.
Controle de versão
Git contextual
O Compazio executa o Git diretamente no repositório do workspace, sem shell intermediário. O nó mostra branch, ahead/behind e mudanças.
Estão disponíveis status, diff, stage, unstage, commit, fetch, pull fast-forward, push, checkout, criação de branch e stash. Rebase visual, graph e um cliente GitHub completo ficam fora desta beta.
Times de agentes
Coordenação visível
Um terminal Claude Code, Codex ou OpenCode pode receber a opção Este agente coordena o time. O coordenador continua em sua TUI real e pode criar terminais visíveis, atribuir papéis, conectar recursos e trocar mensagens pelo bridge local.
compazio me
compazio list
compazio send <destino> "<mensagem>" --wait
compazio inbox
compazio reply <request-id> "<resultado>"Somente reply conclui uma solicitação. Silêncio, output específico do provider ou encerramento do processo não são tratados como resposta.
Referência
Atalhos de teclado
- Ctrl + K
- Buscar ações, workspaces, terminais, notas e arquivos
- Ctrl + Shift + T
- Criar um terminal
- Ctrl + Shift + N
- Criar uma nota
- Ctrl + Shift + E
- Criar uma árvore de arquivos
- Ctrl + Shift + P
- Abrir o Prompt Composer
- Ctrl + Shift + X
- Cortar uma conexão
Local-first
Privacidade e segurança
O processo principal do aplicativo é a autoridade para processos, persistência e Portais. O renderer usa somente uma ponte tipada e validada, com isolamento de contexto e sem integração direta com Node.js.
- Código, prompts completos, credenciais e output ficam locais por padrão.
- Cloud sync, billing, controle remoto e telemetria ficam desativados por padrão.
- Tokens efêmeros não são persistidos no workspace nem enviados ao renderer.
- Writes importantes são atômicos e contam com backups de recuperação.
Public Beta 1
Limites conhecidos
A distribuição pública atual tem alvo Windows x64. WSL, SSH, Docker, rotinas agendadas, marketplace, companion mobile e execução remota ainda não fazem parte da beta.
O instalador pode não ter assinatura Authenticode e o SmartScreen do Windows pode exibir um aviso. O suporte multimodal do OpenCode depende do modelo selecionado.