| 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 only. |
waterbrother models catalog | Browse the built-in cross-provider model catalog. |
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 discord sync-commands | Register or refresh native Discord slash commands against the configured application. |
waterbrother gateway stop [telegram] | Stop the tracked Telegram gateway process. |
waterbrother project share | Enable shared-project mode in the current cwd, create .waterbrother/shared.json plus ROUNDTABLE.md, and guide room mode/runtime/first invite setup when interactive. |
waterbrother project unshare | Disable shared-project mode for the current cwd. |
waterbrother room status | Show shared room state for the current cwd. |
waterbrother room events | Show recent shared-room event activity for the current cwd. |
waterbrother room members | List shared-project members and roles. |
waterbrother room invites | List pending shared-project invites. |
waterbrother room invite <member-id> [owner|editor|observer] | Create a pending shared-project invite. |
waterbrother room invite approve <invite-id> | Approve a pending shared-project invite. |
waterbrother room invite accept <invite-id> | Accept your own pending shared-project invite. |
waterbrother room invite reject <invite-id> | Reject a pending shared-project invite. |
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 assign <id> <member-id> | Assign a Roundtable task to a shared-project member. |
waterbrother room task claim <id> | Claim a Roundtable task for the local user. |
waterbrother room task move <id> <open|active|blocked|done> | Move a Roundtable task between states. |
waterbrother room runtime [name|clear] | Show, set, or clear the shared room runtime profile. |
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 about | Show Waterbrother’s local self-description from repo state. |
waterbrother capabilities | Show Waterbrother capabilities from local self-awareness state. |
waterbrother project-map | Show a repo-first project/codebase map from local state. |
waterbrother state | Show the full self-awareness manifest for the current cwd. |
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. |
Command Reference
Command surface for chat, sessions, onboarding, vision, memory, context compaction, and built-in web research workflows.
| 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. |
| 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. |
| Command | Purpose |
|---|---|
/help | List slash commands. |
/exit, /quit | Exit interactive mode. |
/status | Show current session state, task state, approvals, MCP, and structured runtime details. |
/about | Show Waterbrother’s local self-description from repo state. |
/capabilities | Show Waterbrother capabilities from local self-awareness state. |
/project-map | Show a repo-first project/codebase map from local state. |
/state | Show the full self-awareness manifest for the current cwd. |
/session | Show current session metadata. |
/sessions | List recent sessions. |
/new | Start a new session. |
/resume <id> | Resume a saved session. |
/project | Show the linked project, current cwd, and Roundtable state for the Telegram-linked session. |
/project use <path|name> | Switch the Telegram-linked session to another project or directory. |
/project new <name> | Create a Desktop project and switch the Telegram-linked session into it. |
/project share | Enable Roundtable for the current linked project and bind the active Telegram or Discord chat. |
| Conversational room control | Natural Telegram and Discord requests like add Austin as editor, pair Austin, have Austin's bot be reviewer, make this terminal the verifier, verification mode blocking, rerun verification, override verification, have Phillip's bot take execution, which terminals are live?, or compare executor and reviewer now resolve against live room and agent state. |
/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> | Show the current model or switch it directly. |
/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. Telegram and Discord now both support live room status and control against the same shared project state. |
/room events | Show recent shared-room event activity. |
/room members | List shared-project members and roles. |
/room add <member-id> [owner|editor|observer] | Add or update a shared-project member. |
/room invites | List pending shared-project invites. |
/room invite <member-id> [owner|editor|observer] | Create a pending shared-project invite. |
/room invite approve <invite-id> | Approve a pending shared-project invite. |
/room invite accept <invite-id> | Accept your own pending shared-project invite. |
/room invite reject <invite-id> | Reject a pending shared-project invite. |
/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 assign <id> <member-id> | Assign a Roundtable task to a shared member. |
/room task claim <id> | Claim a Roundtable task for yourself. |
/room task move <id> <open|active|blocked|done> | Move a Roundtable task between states. |
/room task comment <id> <text> | Add a Roundtable task comment. |
/room task history <id> | Show Roundtable task history and comments. |
/room runtime / /room runtime <name|clear> | Show or set the shared room runtime profile. |
/room mode <chat|plan|execute> | Set the collaboration mode for the shared room. |
| Discord native slash + text commands | Discord now supports grouped slash commands like /project share, /task add, and /session resume, plus Discord text commands for the same room actions. Autocomplete is available for invite targets, invite ids, terminal labels, task ids, member ids, and recent session ids. The same room actions also work through /room ... aliases like /room people, /room task ..., /room events, /room invites, /room claim, and /room release. For immediate slash-command availability in a specific server, set channels.discord.guildId before syncing commands. |
/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 active provider only. |
/models all | Browse the built-in cross-provider model catalog and switch in one step. |
waterbrother config set-json mcpServers '{"filesystem":{"command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","."]}}' --scope project
waterbrother mcp list