discord-user-cards

Hermes Agent plugin — Discord user identity cards for the orchestration harness.

Provides tools to look up, create, and update user metadata by Discord user ID. Cards are stored as JSON at ~/.hermes/data/discord-user-cards/cards.json.

New in 1.1.0: Cards are auto-created for unknown users when they're encountered in conversation. The pre_llm_call hook now:

• Detects the message sender and creates a stub card if they're unknown
• Resolves all @mentions in the message text, creating stub cards for any unknown IDs
• Injects resolved identities into the LLM context before every turn

This means cards "happen automagically" — you only need to manually create/update cards when you want to add descriptive prose about a user.

Tools

Tool	Description
lookup_user	Look up a user's identity card by Discord user ID
create_user_card	Create a new identity card for a user
update_user_card	Update fields on an existing card
search_users	Search user cards by keyword
list_all_users	List all known users (summary)

Card Format

{
  "user_id": "376744299783651331",
  "username": "jezzzzzzzzzz",
  "display_name": "Jez",
  "type": "human",
  "card": "Prose description...",
  "maintained_by": "discord-user-cards",
  "version": 1,
  "updated_at": "2026-06-30T00:00:00Z"
}

Development

Clone from Forgejo and symlink into ~/.hermes/plugins/:

git clone git@git.jezzahehn.com:KrustyPlanet/discord-user-cards.git
ln -s $(pwd)/discord-user-cards ~/.hermes/plugins/discord-user-cards

Restart Hermes and enable the plugin:

hermes plugins enable discord-user-cards