Interactive sessions
The terminal user interface (TUI) keeps conversation, tools, and progress in one place. Use slash commands, pick models, and resume previous sessions.
Explore the workflow →WATERBROTHER CLI / TUI
Work with AI directly in your computer’s terminal. Explore a repository, make changes, review the result, and keep the context of your work close.
The standalone terminal app is available separately from the forthcoming iPhone app.
Start on your computer
Install the npm package, then launch WATERBROTHER from your project directory. First-run setup walks through your model provider and credentials.
npm install -g @tritard/waterbrother
waterbrother --approval on-request
A working environment, in your terminal
The terminal user interface (TUI) keeps conversation, tools, and progress in one place. Use slash commands, pick models, and resume previous sessions.
Explore the workflow →Configure a model provider or a compatible local runtime. Keep provider setup and model choices separate from your project instructions.
Model integrations →Choose how actions are approved, use reviewer and verifier workflows, and inspect proposed work as you go.
Commands and controls →Explore the CLI’s Roundtable workflow for shared project context, operator roles, and collaboration across terminals.
CLI Roundtable guide →Find setup instructions for Telegram and Discord, plus the documented status of other messaging integrations.
Messaging guides →
Connect MCP tools, work with screenshots, and keep project
guidance in WATERBROTHER.md across sessions.
Know which path you need
Work at your computer
Use WATERBROTHER directly in a terminal. The CLI has its own interface, setup, commands, and integrations. You don’t need the iPhone app to use it.
Install the terminal app →Connect from your phone
The companion supports remote computer sessions in the iPhone app. It runs on the computer you want to connect to; use the setup instructions provided in the app when you have access.
How the iPhone app works →Installation, command reference, integrations, and troubleshooting are all in the documentation.
Browse documentation →