Hermagotchi

From its catalog listing
Co-op virtual pets for Hermes: raise a pet, fight deterministic async battles, earn Bits, unlock cosmetics up to mythic tier, climb a seasonal leaderboard, and chat, DM, challenge and taunt other players in a native pane in the Hermes web app and Desktop (Habitat, Battle, Shop, Leaderboard and Social tabs plus a persistent lobby rail). Hermes gets 8 composable tools (hermagotchi_status, hermagotchi_pet, hermagotchi_goals, hermagotchi_challenge, hermagotchi_battle, hermagotchi_shop, hermagotchi_social, hermagotchi_meta).
Good to know before installing
by default the tools run an offline practice simulation (in-memory, no network, reset on Hermes restart). Only when the owner sets the network_enabled plugin setting do they act on the real game server, using the device session the pane paired; that state persists server-side. hermagotchi_status health/me report the active backend. Agent autonomy (autonomy-gated game actions such as practice battles) and agent chat need their own settings and are off by default; the agent can never buy items, and pet care/adopt are not gated by the autonomy setting. The network, autonomy and chat settings can also be switched on by the HERMAGOTCHI_NETWORK_ENABLED, HERMAGOTCHI_AGENT_AUTONOMY_ENABLED and HERMAGOTCHI_AGENT_CHAT_ENABLED environment variables. Network traffic goes over HTTPS only (plain HTTP is refused except loopback) to the game API base URL the user configures (the optional hosted API at api.hermagotchi.rizz.click run by the maintainer, or a self-hosted server from docs/deploy). It sends pet, battle, shop and social actions and, if agent chat is enabled, lobby messages, DMs and taunts, which that server stores; other players' messages come back to the agent marked as third-party text. The pairing session token lives in a 0600 file under Hermes plugin data and is never returned by tools or logged. Online, hermagotchi_status op=pair refuses user_code/revoke_device_id (unsupported_online); approve and revoke stay human pane actions so lobby/DM prompt injection cannot attach a stranger's device. The dashboard tab renders with the dashboard SDK's React and authedFetch, used only for same-origin plugin asset and API routes; the Desktop pane uses ctx.rest only (no remote code, no host-token access). No hooks, no middleware, no subprocesses, no inbound ports, and no secrets are requested (requires_env is empty). The dashboard plugin API only proxies an allowlisted set of game routes for the pane.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install hermagotchi - Said no? Turn it on later:
hermes plugins enable hermagotchi - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Everyday life & fun
- Maintained by
- mojomast (Community)
- Needs
- No API keys declared
- Adds tools
hermagotchi_statushermagotchi_pethermagotchi_goalshermagotchi_challengehermagotchi_battlehermagotchi_shophermagotchi_socialhermagotchi_meta- Needs Hermes
- 0.23.0 or newer
- Version
- 0.1.3
- In the catalog
- 2026-11-10
Known issues (from its catalog listing)
- Agent tools default to an offline practice simulation; set network_enabled (plugin setting) to play the real shared game with the pane's paired account. pet rename/set_mode are sim-only. Online pair approve/revoke is pane-only (tool returns unsupported_online).
- Multiplayer (ranked battles, leaderboard, social) needs a game server; the hosted API has a signup cap and no self-serve account deletion yet.
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in everyday life & fun
All everyday life & fun plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher