Docs

Pitwall docs

Pitwall is a desktop app that hosts terminal coding agents and shows which one needs you. Start with the quick start; the guide explains how each part works; the reference covers the CLI, settings, and adding your own agents.

• Quick startInstall, first launch, start an agent, read the flags, Next up, Review and the shortcuts.
• How it worksStatus detection, the Wall, Review, terminals that outlive the app, spaces, accounts, rules, agw machines and the CLI's approvals.
• CLI referenceEvery pitwall command and option, exit status, and recipes for scripts and agents.
• Settings referenceEvery setting, its allowed values and default, where it is stored, and which ones need your approval.
• Agent definitionsAdd any agent CLI with one TOML file: command, resume, worktrees, hooks, rule files and accounts.
• Detection rulesHow status is read from the screen, the rule format, and how to override and test rules.

Help and feedback

Found a mistake, or something missing? Open an issue on GitHub. The reference pages are generated from the code, so they match the version on main; the changelog lists what changed in each release.