feat: add hermes-status plugin#898
Open
Mel-SRK wants to merge 6 commits into
Open
Conversation
Traffic-light status indicator for Hermes Agent (CLI + Gateway). Shows online/busy/attention/degraded/offline states in the status bar with real-time hook-based updates via hermes shell hooks. Features: - Real-time status via hook signal file (sub-second latency) - Fallback polling with configurable interval - Click-to-expand detail panel (Gateway PID, session, tokens, platforms) - Settings UI for script path, poll interval, signal file - Supports Niri compositor
This comment was marked as resolved.
This comment was marked as resolved.
This comment was marked as resolved.
This comment was marked as resolved.
… defaults - Remove unnecessary 'official' property from manifest.json - Add sectionWidgetIndex/sectionWidgetsCount defaults per AGENTS.md - Remove translation fallbacks (tr() handles missing keys) - Replace hardcoded text in Panel.qml with pluginApi?.tr() calls - Replace hardcoded spacing: 4 with Style.marginS - Add i18n/en.json and i18n/zh-CN.json translations
Mel-SRK
force-pushed
the
add-hermes-status
branch
from
8b86860 to
264002e
Compare
spiros132
reviewed
Jun 2, 2026
spiros132
left a comment
spiros132
left a comment
Collaborator
There was a problem hiding this comment.
Some feedback about the PR! :D
| readonly property string scriptPath: { | ||
| var cfg = pluginApi?.pluginSettings || {}; | ||
| var defaults = pluginApi?.manifest?.metadata?.defaultSettings || {}; | ||
| return cfg.statusScript ?? defaults.statusScript ?? "~/.config/noctalia/hermes-status-check"; |
Collaborator
There was a problem hiding this comment.
I would suggest changing this path so that it doesn't point to the root folder of the noctalia config folder. For example maybe it would be better if you used the cache folder, ~/.cache/noctalia/plugins/hermes-status/hermes-status-check
| @@ -0,0 +1,34 @@ | |||
| { | |||
| "id": "hermes-status", | |||
| "name": "Hermes Agent", | |||
Collaborator
There was a problem hiding this comment.
Hermes Agent or Hermes Agent Status?
| "Panel", | ||
| "AI", | ||
| "Indicator", | ||
| "Niri" |
Collaborator
There was a problem hiding this comment.
Is this plugin only for niri or would it also work on the other compositors as well?
Collaborator
There was a problem hiding this comment.
I believe the README file needs to be in English.
| ## 效果 | ||
|  | ||
|
|
||
|  |
Collaborator
There was a problem hiding this comment.
I don't see where these pictures exist.
| NTextInput { | ||
| Layout.fillWidth: true | ||
| text: cfg.statusScript ?? pluginApi?.manifest?.metadata?.defaultSettings?.statusScript ?? "" | ||
| placeholderText: "~/.config/noctalia/hermes-status-check" |
Collaborator
There was a problem hiding this comment.
As before this file shouldn't be in the noctalia config root folder.
| }, | ||
| "metadata": { | ||
| "defaultSettings": { | ||
| "statusScript": "~/.config/noctalia/hermes-status-check", |
Collaborator
There was a problem hiding this comment.
As the above comment, this shouldn't be in the noctalias root config.
- Move config path from ~/.config/noctalia/ to ~/.cache/noctalia/plugins/hermes-status/ - Rename plugin to 'Hermes Agent Status' - Remove Niri tag (no niri-specific APIs used) - Translate README to English - Fix image references
This comment was marked as resolved.
This comment was marked as resolved.
This comment was marked as resolved.
This comment was marked as resolved.
…remove tr() fallbacks
- Add multi-process tracking: per-session process list with ListModel, activeCliCount, process state icons, source labels (GW/CLI/Cron) - Fix pendingRefresh: rapid hook updates no longer dropped when a status check is already in-flight - Fix clearAttention: only clear needsAttention after rm succeeds (onExited callback instead of optimistic clear) - Add missing i18n keys: event.finalizing, event.reset, panel.gw, panel.cli, panel.cron, panel.dead - Bump version to 2.0.0 - Panel: increase size to fit process list, add process helpers
- Add fetchWatchdog (15s): force-resets fetchState if statusProcess onExited never fires (process crash, QML engine bug) - IPC refresh now uses force=true to bypass stuck loading guard - Downgrade stale busy signals for live processes after 180s
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Hermes Agent Status Plugin
Traffic-light status indicator for Hermes Agent (CLI + Gateway) in Noctalia Shell.
What it does
Shows real-time Hermes Agent status in the status bar:
Architecture
Features
Preview
Source
Full source and installation guide: https://github.com/Mel-SRK/noctalia-hermes