Conceitos principais

Dez palavras que o resto desta documentação assume. Leia uma vez; o vocabulário é pequeno de propósito.

Workspace

Uma pasta de projeto aberta. Cada workspace carrega o próprio canvas, os próprios painéis e o próprio estado de git. A lista de projetos recentes na barra lateral alterna entre eles.

O estado por projeto vive dentro do projeto: .cate/workspace.json para o layout do canvas e .cate/session.json para o que estava rodando.

Canvas

A superfície infinita. Os painéis têm coordenadas em espaço de canvas; a viewport as converte para espaço de tela usando o nível de zoom e o deslocamento. Navegar e dar zoom nunca movem um painel — movem a sua vista dele.

Um canvas também pode ser um painel: um canvas aninhado dentro do canvas pai.

Painel

Uma unidade de trabalho no canvas. Sete tipos: terminal, editor, browser, canvas, agente, documento e extensão.

Um painel ou flutua como nó do canvas — barra de título, alça de arraste, cantos de redimensionamento — ou encaixa numa zona de dock como aba. O mesmo registro de painel renderiza dos dois jeitos, então mover de um para o outro não perde nada.

Dock

As zonas fixas nas bordas da janela. Solte um painel ali e ele vira aba; arraste de volta e ele volta ao canvas. Janelas destacadas são janelas de dock, e os painéis delas são sincronizados de volta para a restauração da sessão.

Agente

Um agente de código rodando dentro de um painel de terminal — claude, codex ou a CLI que você abrir. O Catenary não substitui o agente; ele dá um lugar para o agente morar, um nome no canvas e fios até os colegas.

Fio (wire)

Uma conexão direcionada entre dois painéis. Ela carrega contexto: o que a origem produziu fica disponível para o destino. Veja fios de conexão.

Worktree / tarefa

Uma worktree isolada do git, com branch e diretório próprios, criada em um clique. A cor dela acompanha a tarefa na barra lateral, nas abas do dock e no território dentro do canvas. Veja worktrees em 1 clique.

Squad

Uma formação salva de agentes: cargos, presets e os fios entre eles. Carregue um squad e o time inteiro aparece já conectado.

Modo Maestro

Desligado por padrão. Quando você liga, um agente pode recrutar, orientar e conectar um time — e cada ação que ele toma para num cartão de aprovação editável antes de qualquer coisa aparecer no canvas. Veja Modo Maestro.

Território

A ilha colorida desenhada sob todos os painéis que pertencem à mesma worktree. Opcional — um interruptor em Configurações, Worktrees ("Worktree Territories").