Discord Bot Setup

Follow this once to create and invite a bot for Discode. These steps are adapted from docs/DISCORD_SETUP.md.

1) Create the bot application

Open Discord Developer Portal.
Create a new application and open the Bot tab.
Copy the bot token and store it securely.
Never commit or share this token publicly.

2) Enable intents

In Privileged Gateway Intents, enable:

MESSAGE CONTENT INTENT (required)
SERVER MEMBERS INTENT (optional)

Discode also uses reaction events for approval requests via non-privileged intents.

3) Invite the bot to your server

Go to OAuth2 -> URL Generator.
Select scope: bot.
Select permissions listed below.
Open generated URL and authorize for your target server.

Permission	Why it is needed
View Channels	Access and track project channels.
Manage Channels	Create per-project channels automatically.
Send Messages	Post agent output and status updates.
Send Messages in Threads	Support threaded conversations.
Embed Links	Render interactive question/approval embeds.
Read Message History	Context tracking and reaction processing.
Add Reactions	Tool approval flow from Discord reactions.

4) Run onboarding and verify

discode onboard
discode config --show
discode new

If onboarding cannot detect a server, confirm the bot was invited to the correct guild and has the permissions above.

Quick reference card

1. Create app + bot at discord.com/developers/applications
2. Enable MESSAGE CONTENT INTENT
3. Copy bot token
4. OAuth2 > URL Generator: scope=bot
5. Grant permissions and invite bot
6. Run discode onboard
7. Start with discode new