docs(prd): 0017 — put the herd on the Omarchy bar - #527
Merged
Merged
Conversation
An Omarchy bar-widget + panel plugin (sh.moshcode.herd) that renders running agents, blocked agents and the burn windows, fed by a single new read-only command, `moshcode omarchy status --json`. Grounded in the develop/publish docs at plugins.omarchy.org: QML under a shared unsandboxed Quickshell process, manifest.json at the repo root, install from a git URL, listing by GitHub issue. Shapes and timings for the snapshot come from the live CLI (`ps`, `cost --json`, `fleet tree`, ~210ms each on this box). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
ralyodio
marked this pull request as ready for review
September 22, 2026 14:17
ThreatCrush Security Scan0 finding(s) in the 2 file(s) this pull request changes. Nothing in the files this pull request changes. 101 pre-existing finding(s) elsewhere in the repository — **HIGH/CRITICAL**: 8 | **MEDIUM**: 82 | **LOW**: 11Not introduced by this pull request. The full set is in the Security tab.
…and 81 more. Full results in the Security tab. Snippets are redacted; ThreatCrush never prints matched credential material. |
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
1 participant
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.
PRD 0017: an Omarchy bar plugin for the herd, and the one command it reads.
Why. Everything moshcode knows about a running fleet is behind a prompt.
ps,cost,fleet treeare all true and none of them are on screen, so you learn the state of your machine by deciding to ask. The expensive version of that was 2026-09-13 ($131/hour at list, unseen until someone typedmoshcode cost); the common version is an agent sitting inblockedfor twenty minutes holding a pane and a context window.What it proposes.
moshcode omarchy status --json— one read-only, bounded, cached snapshot (agents, counts, burn windows, fleets, alerts) built fromps --json,cost --all --jsonandfleet tree --jsonin a single process boot. Measured at ~210ms each today, so the cache exists for the 1s poll, not for the work.sh.moshcode.herd— abar-widget+panelplugin in its own repo (manifest.jsonhas to sit at the root, becauseomarchy plugin addclones a git URL). One glyph with four states, blocked being the one the whole thing exists for; a dense panel that uses the same words as the CLI.moshcode omarchy validate— the documented marketplace checks reimplemented in JS, so the plugin can be verified in CI on a box with no Omarchy on it.Constraint that shapes it. Omarchy plugins run unsandboxed inside a shared, long-running Quickshell process. A leaked process or an unguarded
JSON.parsetakes down the whole bar for whoever installed it, so 0.1 is read-only, oneProcessat a time, no shell, no writes.Known gap, stated in the PRD. This box is Ubuntu 26.04 with no
omarchy,omarchy-shell,quickshellorqmllint. The CLI half is testable here; every QML requirement needs a real Omarchy install, and that gates the plugin half. Two other open questions want an explicit answer before implementation: the separate plugin repo, and whether the blocked alert should also ship as aservicekind so it works with no widget placed.Draft, per the OpenPRD lifecycle. Index regenerated;
test/prd.test.mjs+test/prd-index-cell.test.mjspass (32/32).🤖 Generated with Claude Code