hermes-tools

Curated, public-facing tools and patches for the Hermes Agent ecosystem (github.com/NousResearch/hermes-agent).

Contents

hermes_skill_audit.py

A dry-run auditor for Hermes skill hygiene. Reads Hermes skill metadata, curator usage sidecars, and CLI source lists, then writes a Markdown report. Never mutates ~/.hermes — read-only by design.

Why this is useful: as your local skill count grows (builtin + agent-created), it becomes hard to know which skills are actually used, which are duplicates, and which can be pruned. This script produces a structured report so a curator (maintainer or agent) can make merge/archive/delete decisions with evidence.

Usage:

python3 hermes_skill_audit.py [--json] [output_path]
# Default: writes Markdown report to stdout
# --json: emits machine-readable JSON

patches/42645-archive-cron-sessions.patch

A patch addressing cron-driven session archival behavior in the Hermes desktop app. Targets apps/desktop/src/app/session/hooks/use-session-actions.ts.

Origin: produced while debugging session-sidebar drift between archive and active state. See commit message for full context.

Apply:

cd path/to/hermes-agent
git apply path/to/42645-archive-cron-sessions.patch

What this repo is NOT

• Not a fork of hermes-agent. No upstream source is mirrored here.
• Not a plugin catalog. Hermes plugins live in their own trees.
• Not a deploy / runtime tool. Nothing here touches ~/.hermes/.

License

Same as upstream Hermes Agent (MIT).

Provenance

Maintained by foras910521-lab. Tools and patches are extracted from a working local Hermes install. If you find an issue, file it on this repo — but the underlying Hermes behavior is owned upstream.