discord_KM
Interact with Discord — read and send messages, browse servers and channels, search conversations, manage DMs, check mentions, and control the Discord desktop app. Use this skill whenever the user men
SKILL.mdskills/personal-ops/discord_KM/SKILL.md
GitHubDiscord
Control Discord via the discord CLI. All commands go through Discord's REST API v10 using the user's own auth token, auto-extracted from the running Discord Electron app.
CLI Location
/opt/homebrew/bin/discord
Usage Pattern
Always use --json --no-input flags for programmatic access:
discord <command> [args] --json --no-input
Common Workflows
Read recent messages from a channel
# Find the guild and channel first
discord guilds --json --no-input
discord channels "Claude" --json --no-input
# Then read messages
discord messages <channel_id> --limit 20 --json --no-input
Send a message
discord send <channel_id> "Message text here" --no-input
Search a server
discord search "Claude" "API documentation" --json --no-input
Check unread mentions
discord unread --json --no-input
Send a DM
discord dm <user_id> "Hey, message here" --no-input
Command Reference
| Command | Args | Description |
|---|---|---|
me |
— | Current user info |
guilds |
— | List all servers |
channels |
<guild> |
Channels in a guild (name or ID) |
messages |
<channel_id> |
Read messages (use --limit N) |
send |
<channel_id> "text" |
Send a message |
reply |
<msg_id> <ch_id> "text" |
Reply to a message |
dm |
<user_id> "text" |
Send a direct message |
dms |
— | List DM channels |
search |
<guild> "query" |
Search messages in guild |
react |
<ch_id> <msg_id> <emoji> |
Add reaction |
unread |
— | Show unread mentions |
members |
<guild> |
List guild members |
roles |
<guild> |
List guild roles |
pins |
<channel_id> |
Pinned messages |
status |
[text] |
Get/set custom status |
navigate |
<channel_id> |
Open in Discord app |
screenshot |
[file] |
Screenshot Discord app |
Guidelines
- Guild and channel arguments accept partial name matches (case-insensitive) or snowflake IDs
- Use
--limit Nto control result count (default 25) - Token is cached in macOS Keychain — auto-refreshes on 401
- If Discord isn't running with CDP, the CLI will try to relaunch it
- For CDP features (navigate, screenshot), Discord must be on port 9224
- Rate limits: ~50 req/s general, ~1 req/s for search
- Parse JSON output with
python3 -c "import json,sys; ..."orjq
Server / forum administration fallback
For Discord server config that the Hermes bot cannot change, prefer the user's validated Discord session over guessing through the GUI. The bot token can read forum channels but may fail writes with Missing Permissions / Discord code 50013, especially for forum tag edits.
Use this pattern for Hermes forum tag updates:
- Use the bot token only to read/diagnose if needed; do not assume it can PATCH channel settings.
- Extract candidate user tokens from local Discord/Chrome LevelDB, validate each with
GET https://discord.com/api/v10/users/@me, and never print or save the token. - For each forum channel,
GET /api/v10/channels/<channel_id>, append missing objects toavailable_tagssuch as{ "name": "immigration", "moderated": true }, thenPATCH /api/v10/channels/<channel_id>with the full updatedavailable_tagsarray. - Verify by re-reading the channel and checking the returned
available_tagsnames.
Known Hermes guild/forum context:
guild: 1489303074970406912
user: ildunari / 339622137826508802
gpt-sessions forum: 1509294060572246257
registry: ~/.hermes/profiles/gpt/discord/forum-profile-sessions-v1.yaml
When the workflow is non-trivial or authenticated, create a web-task-scaffold workspace and keep the final script/log there. Do not store auth state, cookies, tokens, or private page dumps in the artifact.
User's Servers
The user (ildunari, ID: 339622137826508802) has 22 servers including: Claude, Brown Community Discord, Brown University Graduate Students, Google Labs, Coders, OpenClaw, Perplexity, r/Gemini, ildunari's server (owned), and others.