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