Agent DiscordBot

A TypeScript CLI tool that enables AI agents and humans to interact with Discord servers using bot tokens. Unlike agent-discord which extracts user tokens from the desktop app, agent-discordbot uses standard Discord Bot tokens for server-side and CI/CD integrations.

Quick Start

# Set your bot token
agent-discordbot auth set your-bot-token

# Verify authentication
agent-discordbot auth status

# Send a message
agent-discordbot message send 1234567890123456789 "Hello from bot!"

# List channels
agent-discordbot channel list

Authentication

Bot Token Setup

agent-discordbot uses Discord Bot tokens which you create in the Discord Developer Portal:

# Set bot token (validates against Discord API before saving)
agent-discordbot auth set your-bot-token

# Set with a custom bot identifier
agent-discordbot auth set your-bot-token --bot deploy --name "Deploy Bot"

# Check auth status
agent-discordbot auth status

# Clear stored credentials
agent-discordbot auth clear

Getting a Bot Token

1. Go to discord.com/developers/applications
2. Click New Application, give it a name, and create
3. Go to Bot in the left sidebar
4. Click Reset Token (or Copy if the token is still visible)
5. Copy the token and store it securely

Inviting the Bot to a Server

After creating the application:

1. Go to OAuth2 > URL Generator in the left sidebar
2. Under Scopes, select bot
3. Under Bot Permissions, select the permissions your bot needs (Send Messages, Read Message History, etc.)
4. Copy the generated URL and open it in your browser
5. Select the server and authorize

Message Content Privileged Intent

Bots in 100 or more servers require verification (you can apply once you reach 75+ servers), and verified bots must apply for access to the Message Content intent. Enable it to read message content:

1. Go to discord.com/developers/applications
2. Select your application
3. Go to Bot in the left sidebar
4. Under Privileged Gateway Intents, enable Message Content Intent
5. Save changes

Without this, verified bots receive empty content fields (DMs and mentions are exempt).

Multi-Bot Management

Store multiple bot tokens and switch between them:

# Add multiple bots
agent-discordbot auth set deploy-bot-token --bot deploy --name "Deploy Bot"
agent-discordbot auth set alert-bot-token --bot alert --name "Alert Bot"

# List all stored bots
agent-discordbot auth list

# Switch active bot
agent-discordbot auth use deploy

# Use a specific bot for one command (without switching)
agent-discordbot message send 1234567890123456789 "Alert!" --bot alert

# Remove a stored bot
agent-discordbot auth remove deploy

The --bot <id> flag is available on all commands to override the active bot for a single invocation.

Memory