# Documentation Catalog

This repo does not use a generated docs site. The files below are the current source of truth.

## Canonical Docs

- `docs/TERMINAL-DISPLAY.md` — Agent-specific terminal rendering policy, attach/resize/reveal lifecycle, redraw rules
- `docs/ADAPTERS.md` — Agent integration status, hooks, capabilities, and upstream-vs-Jacques notes
- `docs/GUI.md` — Current `gui-v2` architecture and terminal UI wiring
- `docs/SERVER.md` — Current server architecture, terminal attach flow, and WebSocket behavior
- `docs/PITFALLS.md` — Terminal and multi-agent implementation pitfalls that have caused real bugs

## Supporting Docs

- `docs/REMOTE.md` — Remote access, auth flow, and troubleshooting
- `docs/STATE.md` — Shared preference and persistence model
- `docs/CONNECTION.md` — Session connection, worktree, and lifecycle details
- `docs/PLATFORM-SUPPORT.md` — OS/platform differences

## Historical / Research Docs

- `docs/REMOTE-TERMINAL-PLAN.md` — Historical implementation plan; not the current terminal architecture source of truth
- `docs/MULTI-TOOL-ADAPTERS.md` — Integration research document; useful context, but not current implementation truth