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.

O Canvas é uma de duas lentes. O TerminalMap mostra os mesmos painéis como splits de terminal guiados pelo teclado; ⌥⌘S alterna entre os dois, e nada reinicia.

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 entre dois painéis. Por padrão ela é uma permissão: os agentes das duas pontas se alcançam com catenary ask, e nada viaja até um deles pedir. Ela também pode repassar sozinha cada turno terminado. 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. Recrutar ou dispensar um agente para num cartão de aprovação editável antes de qualquer coisa aparecer no canvas; conectar dois agentes do time é aprovado sozinho, a menos que estejam em worktrees diferentes. 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").