Waterbrother
Bring-your-own-model terminal workflows

Your model, your terminal.

Waterbrother is a local coding CLI for approvals, sessions, vision, project memory, MCP, and web research across OpenAI, Anthropic, OpenRouter, Ollama, xAI, and compatible APIs.

Start onboarding Install Waterbrother Browse commands

Built for terminal-native work: resumable sessions, exact shell routing, vision prompts, MCP extensions, and local-first control.

Slash Palette, approvals, deterministic shortcuts
Vision Screenshots, dropped images, UI critique
Memory Sessions, compaction, WATERBROTHER.md
Quick start

Install and launch

npm install -g @tritard/waterbrother
waterbrother --approval on-request

First launch handles provider selection, API key setup when needed, model selection, and defaults. Source installs remain documented for contributors.

Integrations

Models, messaging, tools

Waterbrother now has a first-class integrations surface covering bring-your-own-model runtime profiles, Telegram remote control, MCP tools, and the staged path to Discord and Signal.

Open integrations overview

Channels

Remote control foundation

Messaging support is being built gateway-first: deterministic routing, service-specific onboarding, and single-user terminal control before collaboration.

Review channel guidance

Approvals

Review risky actions before they run

Keyboard-first prompts, session-scoped command rules, exact-shell blocking for dangerous commands, and interruptible long-running tool calls.

Vision

Screenshots into action

Drop a screenshot into the terminal, run /vision, or use waterbrother vision to turn UI critique into concrete next steps.

MCP

Bring external tools into the loop

Configure project-level MCP servers, inspect them with /mcp, and expose structured tools without giving up control of the local workflow.

Interactive UX

Built for long sessions

  • Type / to open the command palette and slash help.
  • Use ↑/↓ to move through command, model, and approval pickers.
  • Use /compact and auto-compaction to keep giant sessions moving.
  • Resume past work with /sessions, /resume, and durable on-disk session state.
Project memory

Keep source-of-truth close to the work

WATERBROTHER.md is loaded into the session as persistent project guidance. Pair it with session save, deterministic git helpers, and explicit docs so collaborators stay aligned across long-running work.