Waterbrother

Discord Setup For Beginners

Use Discord for DM-first control first. Create the bot, enable Message Content intent, save the token and application id in Waterbrother config, then run the Discord Gateway loop locally through the normal TUI-managed startup path.

Open Discord Developer Portal Back To Onboarding
Step 1

Create the application

  1. Open the Discord Developer Portal.
  2. Click New Application.
  3. Name it Waterbrother.
  4. Copy the Application ID from General Information.
Step 2

Create the bot

  1. Open the Bot tab.
  2. Click Add Bot.
  3. Enable Message Content Intent.
  4. Reset and copy the Bot Token.
export DISCORD_BOT_TOKEN=your_token_here
export DISCORD_APPLICATION_ID=your_application_id_here
Step 3

Save config in Waterbrother

Store the Discord token and application id directly in Waterbrother config, the same way Telegram setup works in the TUI onboarding flow.

waterbrother config set-json channels '{"discord":{"enabled":true,"botToken":"YOUR_BOT_TOKEN","applicationId":"YOUR_APP_ID","pairingMode":"manual","allowedUserIds":[]}}'
Step 4

Invite the bot

Use OAuth2 URL Generator in the Discord portal.

  • Scope: bot
  • Permissions: View Channels, Send Messages, Read Message History, Create Public Threads, Create Private Threads, Send Messages in Threads
Step 5

Sync slash commands and run the Gateway loop

waterbrother discord status
waterbrother discord sync-commands
waterbrother discord run

Waterbrother now syncs native Discord slash commands, grouped subcommands, and autocomplete-backed targets, then handles DMs, mentions, text commands, and slash-command execution through the live TUI bridge. If you want commands to appear immediately in one server, set channels.discord.guildId so sync stays guild-scoped instead of falling back to slower global registration.