Commands · Waterbrother

Command	Purpose
`waterbrother [prompt]`	One-shot prompt or interactive mode.
`waterbrother chat [prompt]`	Explicit chat form.
`waterbrother exec <prompt>`	Non-interactive execution command form.
`waterbrother review <prompt>`	Non-interactive review run (defaults to reviewer profile).
`waterbrother resume [<session-id>] [prompt]`	Resume a previous session, optionally with a new prompt.
`waterbrother vision <image-path> <prompt>`	Vision analysis from local image.
`waterbrother mcp list`	Start configured MCP stdio servers, discover tools, and print connection status.
`waterbrother config set <key> <value> [--scope user\|project]`	Persist config in user config by default, or in `.waterbrother/config.json` with `--scope project`.
`waterbrother config set-json <key> <json> [--scope user\|project]`	Persist structured JSON values such as `mcpServers`.
`waterbrother config get <key> [--scope user\|project\|merged]`	Read a config key from a chosen scope. Default is merged runtime config.
`waterbrother config list [--scope user\|project\|merged]`	Print config for a chosen scope. Default is merged runtime config.
`waterbrother sessions list`	List recent sessions.
`waterbrother sessions show <id>`	Display a saved session.
`waterbrother sessions latest`	Show most recent session record.
`waterbrother models list`	List model IDs from the active provider or provider catalog.
`waterbrother models catalog`	Show local model metadata table.
`waterbrother models status`	Show active provider, model, design model, base URL, and API-key status.
`waterbrother runtime-profiles list`	List saved runtime provider/model presets.
`waterbrother runtime-profiles show <name>`	Show one saved runtime preset.
`waterbrother runtime-profiles save <name>`	Save the current runtime as a named preset.
`waterbrother runtime-profiles apply <name>`	Apply a named runtime preset to your saved user defaults.
`waterbrother channels list`	List supported messaging services.
`waterbrother channels status`	Show readiness for Telegram, Discord, and Signal.
`waterbrother channels show <service>`	Show readiness details for one messaging service.
`waterbrother gateway status`	Show gateway control mode, bind address, port, and enabled channels.
`waterbrother gateway pairings`	List pending Telegram pairing requests and currently paired user ids.
`waterbrother gateway pair telegram <user-id>`	Approve a pending Telegram user id without hand-editing config.
`waterbrother gateway unpair telegram <user-id>`	Remove a paired Telegram user id.
`waterbrother gateway run telegram`	Run the Telegram single-user remote-control loop.
`waterbrother gateway stop [telegram]`	Stop the tracked Telegram gateway process.
`waterbrother project share`	Enable shared-project mode in the current cwd and create `.waterbrother/shared.json` plus `ROUNDTABLE.md`.
`waterbrother project unshare`	Disable shared-project mode for the current cwd.
`waterbrother room status`	Show shared room state for the current cwd.
`waterbrother room members`	List shared-project members and roles.
`waterbrother room add <member-id> [owner\|editor\|observer]`	Add or update a shared-project member.
`waterbrother room remove <member-id>`	Remove a shared-project member.
`waterbrother room tasks`	List Roundtable tasks for the shared project.
`waterbrother room task add <text>`	Add a Roundtable task for the shared project.
`waterbrother room task move <id> <open\|active\|blocked\|done>`	Move a Roundtable task between states.
`waterbrother room mode <chat\|plan\|execute>`	Set the collaboration mode for the shared room.
`waterbrother room claim`	Claim the shared room operator lock as the local terminal user.
`waterbrother room release`	Release the shared room operator lock as the local terminal user.
`waterbrother onboarding`	Print onboarding steps and model guidance.
`waterbrother onboarding telegram\|discord\|signal`	Print service-specific messaging onboarding.
`waterbrother doctor`	Run local readiness checks.
`waterbrother update`	Upgrade npm installs globally to `@tritard/waterbrother@latest`, or update source clones via git pull + check.

Flags

Flag	Purpose
`--model <id>`	Override active model.
`--agent <profile>`	Set startup profile: coder/designer/reviewer/planner.
`--design-model <id>`	Set fallback model for vision/design turns.
`--api-key <key>`	Pass API key at runtime.
`--base-url <url>`	Override API base URL.
`--cwd <path>`	Set working directory sandbox root.
`--approval auto\|on-request\|never`	Set tool approval behavior.
`--trace on\|off\|verbose`	Control turn trace verbosity.
`--auto-compact-threshold <value>`	Auto-compact at ratio: `0` disables, else `0.5-0.99`.
`--no-tools`	Disable tool calling.
`--allow-outside-cwd`	Allow file operations outside cwd sandbox.
`--session <id>`	Resume existing session.
`--last`	Use most recent session when running `resume`.
`--skip-onboarding`	Skip first-run wizard.
`--print-session-id`	Print session id at startup.
`--json`	Machine-readable output for utility commands.
`-p`	Run in headless pipe mode for stdin/stdout automation.
`--output-format text\|json\|stream-json`	Select pipe-mode output format.

Web Research

Pattern	What happens
`waterbrother "Read https://example.com and summarize it"`	Uses the built-in webpage reader for direct URL fetches.
`waterbrother "Search the web for the latest model provider pricing and cite sources"`	Uses built-in web search, then reads relevant result pages.
`Paste https://example.com/ in interactive mode`	Auto-reads the URL and summarizes it, with an optional trailing question.
`Paste a GitHub repo URL`	Uses the dedicated GitHub repo reader instead of shell guesses.

Interactive Slash Commands

Command	Purpose
`/help`	List slash commands.
`/exit`, `/quit`	Exit interactive mode.
`/status`	Show current session state, task state, approvals, MCP, and structured runtime details.
`/session`	Show current session metadata.
`/sessions`	List recent sessions.
`/new`	Start a new session.
`/resume <id>`	Resume a saved session.
`/cwd`	Show the current working directory for the live session.
`/use <path>`	Switch the live session to a different working directory.
`/desktop`	Switch the live session to `~/Desktop`.
`/new-project <name>`	Create a folder on `~/Desktop` and switch into it.
`/run <prompt>`	Run a normal prompt without treating it as a slash command.
`/fork`	Fork the current conversation into a new session id.
`/clear`	Clear current conversation history.
`/compact`, `/compact <keep-last>`	Summarize older history and keep recent turns.
`/cost`	Show session token usage and estimated model cost.
`/diff`	Show staged, unstaged, and untracked git changes in the current repo.
`/model` / `/model <id>`	Get/set active model.
`/provider` / `/provider <id>`	Get/set active provider for the session.
`/providers`	Choose a provider from the supported list.
`/runtime`	Show active runtime profile, provider, model, and design model.
`/runtime-profiles`	List saved runtime presets.
`/runtime-profile`	Choose and load a saved runtime preset.
`/runtime-profile save <name>`	Save the current runtime as a named preset.
`/runtime-profile load <name>`	Load a named runtime preset.
`/channels`	Show messaging channel readiness.
`/gateway`	Show messaging gateway readiness.
`/gateway stop`	Stop the tracked Telegram gateway process.
`/share-project`	Enable shared-project mode in the current cwd.
`/unshare-project`	Disable shared-project mode in the current cwd.
`/room`	Show shared room status for the current project.
`/room members`	List shared-project members and roles.
`/room add <member-id> [owner\|editor\|observer]`	Add or update a shared-project member.
`/room remove <member-id>`	Remove a shared-project member.
`/room tasks`	List Roundtable tasks for the shared project.
`/room task add <text>`	Add a Roundtable task.
`/room task move <id> <open\|active\|blocked\|done>`	Move a Roundtable task between states.
`/room mode <chat\|plan\|execute>`	Set the collaboration mode for the shared room.
`/room claim`	Claim operator control for the shared room.
`/room release`	Release operator control for the shared room.
`/gateway pairings`	List pending Telegram pairing requests from inside interactive mode.
`/gateway pair <user-id>`	Approve a pending Telegram user id from interactive mode.
`/gateway unpair <user-id>`	Remove a paired Telegram user id from interactive mode.
`/agent` / `/agent <profile>`	Get/set active profile.
`/read <url>`	Read and summarize a public webpage URL.
`/search <query>`	Search the web, show selectable results, then read the chosen result.
`/open <url\|index>`	Open a public URL or a saved search result index in your browser.
`/approval <mode>`	Set approval mode.
`/approvals`	Show saved session approval rules for shell prefixes and tools.
`/tools <on\|off>`	Enable or disable tools.
`/trace`, `/trace <mode>`	Show/set trace mode: on/off/verbose.
`/receipt-mode`, `/receipt-mode <auto\|off\|verbose>`	Show/set receipt summary mode.
`/memory`	Show WATERBROTHER.md memory status and path.
`/memory show`	Print current WATERBROTHER.md content.
`/memory add <text>`	Append note to WATERBROTHER.md and reload prompt memory.
`/memory reload`	Reload WATERBROTHER.md into system prompt.
`/memory init`	Create starter WATERBROTHER.md in current project.
`/vision <path> <prompt>`	Vision turn on local image.
`/doctor`	Run doctor checks.
`/mcp`	Show configured MCP servers, connection results, and discovered tools.
`/update`	Update source clones via git pull + check, or upgrade npm installs globally.
`/onboarding`	Print setup guide.
`/onboarding telegram\|discord\|signal`	Print service-specific setup steps.
`/models`	Choose a model from the current provider catalog.

MCP Config

waterbrother config set-json mcpServers '{"filesystem":{"command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","."]}}' --scope project
waterbrother mcp list

Command Reference