Skip to content

docs(readme): add hermes-telemetry to Community section - #56441

Open
nujovich wants to merge 2 commits into
NousResearch:mainfrom
nujovich:docs/community-hermes-telemetry
Open

docs(readme): add hermes-telemetry to Community section#56441
nujovich wants to merge 2 commits into
NousResearch:mainfrom
nujovich:docs/community-hermes-telemetry

Conversation

@nujovich

@nujovich nujovich commented Jul 1, 2026

Copy link
Copy Markdown

What & why

Adds a one-line entry under Community for hermes-telemetry, an MIT,
runtime-integrated plugin (installed into ~/.hermes/plugins/) that hooks into
the model-call pipeline to record per-session and per-cron token, cost, and
latency into local SQLite — and, unlike report-after-the-fact dashboards, can
pause a cron run before it breaches a soft/hard budget cap.

The gap it fills

Observability tools already report what was spent. What multiple users have
asked for is a guardrail that stops spend before it happens, for unattended
(cron/gateway) operation:

Evidence the pain is real: #44771 (91M-token runaway loop), #45782
(unexpected $145 in API costs), #45783 (credit spikes on session resume).

hermes-telemetry implements exactly this enforcement path via the plugin
hooks, plus /stats and /budget, with OpenRouter pricing auto-synced.

Relationship to native work

This complements — it does not replace — the first-class telemetry effort in
#51714 and the budget-enforcement hook proposal in #52648. It's an opt-in,
available-today option for users who need a spend guardrail now.

Links

How to test

Markdown-only change — verify the rendered Community section.

Platforms

N/A (docs).

@alt-glitch alt-glitch added type/docs Documentation improvements comp/plugins Plugin system and bundled plugins P3 Low — cosmetic, nice to have labels Jul 1, 2026

@teknium1 teknium1 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for surfacing a standalone plugin that uses Hermes' existing plugin path.

Problems

  • README.md:256 overstates the enforcement guarantee. The linked plugin documents that soft status injects a notice; hard status blocks subsequent tool calls and pauses future cron runs; an in-flight model response remains billable (plugin README:1171-1185).

Suggested changes

  • Replace “pauses a cron run before it breaches a soft/hard budget cap” with wording that describes the documented post-hard-breach guardrail.

Automated hermes-sweeper review.

Comment thread README.md Outdated
- 🐛 [Issues](https://github.com/NousResearch/hermes-agent/issues)
- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — Linux desktop-control MCP server for Hermes and other MCP hosts, with AT-SPI accessibility trees, Wayland/X11 input, screenshots, and compositor window targeting.
- 🔌 [HermesClaw](https://github.com/AaronWong1999/hermesclaw) — Community WeChat bridge: Run Hermes Agent and OpenClaw on the same WeChat account.
- 🔌 [hermes-telemetry](https://github.com/nujovich/hermes-telemetry) — Local-first cost observability with budget enforcement: hooks into the Hermes runtime to record per-session and per-cron token, cost, and latency in SQLite, and pauses a cron run before it breaches a soft/hard budget cap. Adds `/stats` and `/budget`, with OpenRouter pricing auto-synced.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This overstates the linked plugin's documented guarantee: soft status only injects a notice, while a hard breach blocks subsequent tool calls and pauses future cron runs; an in-flight model call still completes and is billed. Please describe that post-breach behavior rather than claiming prevention before a soft/hard breach.

@teknium1 teknium1 added the sweeper:blast-contained Sweeper blast radius: contained — one narrow path / opt-in / few users label Jul 15, 2026
Describe the guardrail as post-hard-breach (blocks further tool calls,
pauses future cron runs) instead of a pre-breach cron pause. Matches the
plugin's documented Enforcement Levels; the in-flight model response is
still billable.
@nujovich

Copy link
Copy Markdown
Author

Good catch — the previous wording implied a pre-breach cut, which the plugin doesn't do. Fixed in 6258a3d.

The entry now describes the documented post-hard-breach guardrail: on a hard breach it blocks further tool calls and pauses future cron runs, and it's explicit that the in-flight model response still completes and is billed. This matches the plugin's Enforcement Levels table.

@nujovich
nujovich requested a review from teknium1 July 15, 2026 14:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/plugins Plugin system and bundled plugins P3 Low — cosmetic, nice to have sweeper:blast-contained Sweeper blast radius: contained — one narrow path / opt-in / few users type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants