| 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/server.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/server.yaml
Output
Creates/updates ./config/server.yaml with:
server_id: Your Discord server ID
server_name: Server display name
data_dir: Where messages are stored
retention_days: Default sync history
Prerequisites
./.env file with DISCORD_USER_TOKEN set (in cwd)
Next Steps
After init, use discord-sync to download messages.