Discord Doctor

Diagnose configuration and connectivity issues with Discord integration.

When to Use

• User says “Discord not working” or “diagnose Discord”
• User reports connection or authentication errors
• User says “check Discord setup” or “troubleshoot Discord”
• Before asking for help with Discord issues
• When sync or other Discord commands fail unexpectedly

How to Execute

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_doctor.py

What It Checks

1. Environment file – .env exists in cwd
2. Discord token – DISCORD_USER_TOKEN is set
3. Token format – Token appears valid (length, no prefixes)
4. Authentication – Token can connect to Discord API
5. Config file – config/agents.yaml exists and is valid YAML
6. Server configured – A default server is selected
7. Data directory – data/ is writable

Output

Displays results with:

• ✓ for passed checks
• ✗ for failed checks

For each failure, provides a suggested fix that the user can run manually.

Important: This tool only diagnoses issues – it does not modify any files.

Example Output

discord-doctor results:

  ✓ Environment file (.env found)
  ✓ Discord token (***...abc123)
  ✓ Token format (Format looks valid)
  ✗ Authentication (Token expired)
  ✓ Config file (Valid YAML)
  ✓ Server configured (My Server (1234))
  ✓ Data directory (./data)

Some checks failed. Suggested fixes:

  • Authentication:
    Your token may be expired. Get a fresh token from Discord DevTools.

(Run these steps manually - doctor does not modify files)

Next Steps

After fixing issues:

1. Run discord-init to reconfigure if needed
2. Run discord-sync to test connectivity