Discord Init

Automatically configure the Discord server from your account.

When to Use

• User says "set up Discord" or "configure Discord"

• User says "connect my Discord account"

• User says "initialize Discord"

• First time setup before syncing

• When config/agents.yaml doesn't exist or needs updating

How to Execute

Auto-detect and save server:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_init.py

Select a specific server:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_init.py --server SERVER_ID

What It Does

All paths are relative to cwd (current working directory):

• Connects to Discord using your token from ./.env

• Lists all servers you have access to

• If one server: auto-selects it

• If multiple: selects the first one (or use --server to pick)

• Saves configuration to ./config/agents.yaml

Output

Updates ./config/agents.yaml with Discord settings:

• discord.default_server_id : Your Discord server ID

• discord.default_server_name : Server display name

• data_dir : Where messages are stored (shared setting)

• discord.retention_days : Default sync history

Prerequisites

• ./.env file with DISCORD_USER_TOKEN set (in cwd)

• Get your token: https://discordhunt.com/articles/how-to-get-discord-user-token

Next Steps

After init, use discord-sync to download messages.