name: discord-init description: "Initialize Discord configuration. Use when user wants to set up, configure, or connect their Discord account for the first time."

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):

1. Connects to Discord using your token from ./.env
2. Lists all servers you have access to
3. If one server: auto-selects it
4. If multiple: selects the first one (or use --server to pick)
5. 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.