Skip to content

Add a Hermes collector for the agents usage panel - #8626

Closed
smfworks wants to merge 1 commit into
omacom:quattrofrom
smfworks:feat/hermes-agent-usage
Closed

smfworks wants to merge 1 commit into
omacom:quattrofrom
smfworks:feat/hermes-agent-usage

Conversation

@smfworks

Copy link
Copy Markdown
Contributor

Why

The agents bar panel is display-only. It picks up any omarchy-agent-usage-<agent> collector. Claude, Codex, and Fireworks ship; Hermes does not.

What

  • omarchy-agent-usage-hermes prints the panel record from local state.db (~/.hermes + existing ~/.hermes/profiles/*)
  • Queries session_model_usage and user messages; probes sqlite_master / PRAGMA table_info so a schema bump does not crash the updater
  • No 5-hour/weekly limits — Hermes is multi-provider. tierLabel is the dominant billing provider
  • Missing Hermes or a truncated db still prints valid JSON (ready: false) so sibling collectors are not failed
  • Optional assets/hermes.svg mark
  • Zero QML changes

Test plan

  • bash test/shell.d/agent-usage-hermes-scanner-test.sh
  • ./test/cli (metadata)
  • Live scan of this machine's James profile state.db (ready, grok-4.6 + glm models, empty limits)

Rollback: revert the branch. Existing ~/.local/state/omarchy/agents/usage/hermes.json can be deleted; the panel hides agents with no record.

Reads local state.db (default home plus existing profiles). No invented
5-hour/weekly limits — Hermes is multi-provider. Missing or truncated
databases still print valid JSON so the updater does not fail.
Copilot AI balanced review requested due to automatic review settings August 27, 2026 16:41

Copilot AI 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.

Pull request overview

Adds Hermes Agent usage collection to the agents panel using local profile databases.

Changes:

  • Adds the Hermes collector with schema-tolerant SQLite scanning.
  • Adds scanner tests and collector documentation.
  • Adds an optional Hermes panel icon.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

Reviewed changes

Copilot reviewed 3 out of 5 changed files in this pull request and generated no comments.

Show a summary per file
File Description
bin/omarchy-agent-usage-hermes Implements Hermes usage collection.
test/shell.d/agent-usage-hermes-scanner-test.sh Tests database scanning and failure handling.
shell/plugins/agents/README.md Documents Hermes data sources.
shell/plugins/agents/assets/hermes.svg Adds the Hermes panel mark.
manual/17-ai.md Lists Hermes as supported.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@smfworks

Copy link
Copy Markdown
Contributor Author

Closing in favor of #6645 / #6647.

Same collector (omarchy-agent-usage-hermes over local state.db + profiles, defensive sqlite, no invented quotas). #6647 also does remote-gateway usage and the panel UI for it — the hole this PR left open.

Zero QML here was deliberate; #6647 already has the QML. No unique collector behavior worth keeping.

@smfworks

Copy link
Copy Markdown
Contributor Author

Superseded by #6647.

@smfworks smfworks closed this Aug 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants