Repository navigation
Releases
GitHermes v0.5.0 — footer update
GitHermes v0.5.0
Footer update. Your session's branch and PR now live in the status bar, lists say how much they show and grow on demand, and one tap asks Hermes about any PR.
Still no backend. Data comes from authenticated
ghviashell.exec.
Highlights
- One-tap Ask Hermes — any PR reviewed in one click, straight from the detail view
- Branch in the footer —
owner/repo · branchof the focused session, always live next to the PR pill - Session PR pill — the linked PR follows your session in
statusBar.right, truncated and width-bounded - Show more lists — PR and issue lists say "Showing latest N" and grow 30 → 60 → 120; refetch failures keep your rows with an inline Retry
- Merged PRs auto-unlink — the session falls back to main once a PR merges or closes, until the next one opens
Technical notes
Session branch guard (#72)
SessionBranchStatus reuses useSessionGit(host.state.cwd) — no new data source. It hides unless both branch and repo resolve, so remote-less checkouts can never open a stale repository. Glyph matches the composer coding row (size prop, composer green).
Bounded list growth (#73)
gh list has no cursor, so Show more doubles --limit against the server prefix (capped by LIST_LIMIT_CAP). placeholderData holds previous rows across the key change, and the shared ListMoreFooter (retry / more / null) also renders under filtered empty states.
Verification: npm test 72/72, node --check, LSP diagnostics 0.
Merged PRs in this release
- #68
fix(titlebar): move session PR chip to the status bar— @claudioorjunior - #70
fix(ask-hermes): shorten PR toolbar label to 'Ask Hermes'— @claudioorjunior - #71
fix(session): unlink transcript PRs once merged or closed— @claudioorjunior - #72
feat(statusbar): show focused session's working branch— @claudioorjunior - #73
feat(lists): explicit caps with load more on demand— @claudioorjunior
Closes #69.
Install
hermes plugins install claudioorjunior/githermes --enableRequires Hermes Desktop + authenticated gh.
GitHermes is a community plugin and is not an official Nous Research product.
🇧🇷 Português (Brasil)
Update do footer. A branch e o PR da sessão ativa moram na barra de status, as listas dizem quantos itens mostram e crescem sob demanda, e um toque pergunta ao Hermes sobre qualquer PR. PRs mergeados desvinculam sozinhos.
PRs: #68, #70, #71, #72, #73 (todos @claudioorjunior). Issue fechada: #69. MIT · @hermes/plugin-sdk · só gh.
GitHermes v0.4.0 — in-pane workflow
GitHermes v0.4.0
In-pane GitHub workflow release. Shared pane/page state, cheaper live polling, faster conversation loads, and the remaining list/detail actions from spec #21.
Still no backend. Data comes from authenticated
ghviashell.exec.
Highlights
- Shared shell state — repository, tab, query and selected detail stay in sync between the GitHub pane and full page, including plugin hot reloads
- Faster PR conversations — comments, reviews and inline threads start together instead of waiting in sequence
- Tiered polling — lists and conversations poll at 30s, pending checks at 10s, stable checks and headers at 60s, files/commits only on focus; hidden panes and background windows stop polling
- Faster scrolling — Markdown parsing and timeline assembly are memoized against their source data
- Symmetric filters —
author:andlabel:work on both PR and issue lists, with clickable tokens - Keyboard list flow —
/focuses search,Escapeclears it,Enteropens a single result - Copy checkout — PR detail exposes a copyable
gh pr checkout owner/repo#number
Technical notes
Conversation parallelism (#27)
PrDetail now loads comments, reviews and inline threads with Promise.all. Each source still reads large payloads with an internal concurrency cap of 1, so the fan-out stays at three host requests.
Visibility-aware polling (#34)
livePollInterval is a tested pure function. refetchIntervalInBackground is gone. GitHubPane reads host.paneVisibility('githermes:pane') defensively and passes active into list/detail queries.
Bounded large payloads (#28)
readChunksConcurrently defaults to four workers. Overlap is preserved; the test asserts both overlap and the four-worker ceiling.
Filters (#30)
gh pr list --json now includes labels, so PR rows can render LabelChip and issue authors can become author: tokens.
Verification: npm test 42/42, node --check, LSP diagnostics 0.
Merged PRs in this release
- #53
feat: complete GitHermes v0.4 in-pane workflow
Closes #21, #26, #27, #28, #29, #30, #31, #33, #34.
Install
hermes plugins install claudioorjunior/githermes --enableRequires Hermes Desktop + authenticated gh.
GitHermes is a community plugin and is not an official Nous Research product.
🇧🇷 Português (Brasil)
Release do fluxo GitHub no pane. Estado compartilhado entre pane e página (incluindo hot reload), conversa do PR em paralelo, polling por volatilidade e visibilidade, Markdown/timeline memoizados, filtros author:/label: simétricos, atalhos / Escape Enter, e comando gh pr checkout copiável.
PRs: #53. Issues fechadas: #21, #26–#31, #33, #34. MIT · @hermes/plugin-sdk · só gh.
hermes-github-prs v0.3.0 — UI polish
hermes-github-prs v0.3.0
Special UI release. The pane now matches the density of GitHub's own PR page without leaving Hermes Desktop.
Polished list/detail hierarchy, timeline conversation, jump-to-latest, exact
#Nsearch. Still no backend —ghviashell.exec.
Highlights
- Filled PR / Issue headers — kicker (
Pull request/Issue), grouped meta chips, title glued to#, radial pattern on--ui-editor-surface-background - Conversation rail — comments and commits share a
gh-timeline; Quote is icon-only on hover/focus; inline threads keepfile:lineon a second line with a contained diff - Checks in the conversation — compact strip
Blocked/Waiting/All passedviasummarizeChecks(failures first, nativeStatusDot, collapsible). Dedicated Checks tab stays - Commits as
<details>— lazy panel (full message,+/−, up to 20 files). SHA and external link do not toggle the row - Files unboxed —
FileDiffBlockheader is loose; border only on the diff body - Repo picker pill — 32px chip, owner avatar
https://github.com/{owner}.png,owner / name - Jump to latest — floating control, Radix viewport only (
[data-radix-scroll-area-viewport]); remeasures whenheaderQ.datamounts so a cachedconvQcannot leaveatBottom === trueand hide the button - Exact
#Nfilter —numericListQuery();#42matches PR 42, not 142;# 42(space after hash) still parses - Theme inheritance — fields on
--ui-editor-surface-background(matte/glass from Desktop); cards on--ui-bg-quaternary; container queries at<360/<300/<240
Technical notes
Hook order / TDZ (#20)
useEffect for atBottom used to sit below if (headerQ.isLoading) return. First paint without cache changed hook count (Rendered more hooks than during previous render). Effect now lives above every early return, with if (!el) return.
A later Codex note: if convQ resolved before headerQ, the effect ran during the loading return (no viewport) and never again ([convQ.data, page] unchanged). headerQ.data is now in the dependency list so measurement re-runs when the detail DOM mounts.
Viewport scroll (#20)
onScrollCapture previously used e.target, so nested overflow-x-auto (code blocks / tables) overwrote atBottom and hid Jump to latest. Handler now ignores anything that is not [data-radix-scroll-area-viewport].
Exact #N (#20)
matchesListQuery was substring. Query starting with # now compares item.number === n before any string match.
Layout (#19)
Pure helpers summarizeChecks / sortChecks. Large payloads still go through shBig (base64 chunks). SDK stubs (StatusDot, …). node --check + npm test 17/17.
Merged PRs in this release
- #19
feat(ui): polished list/detail hierarchy and check/commit layouts - #20
fix(ui): address Codex/Pullfrog review — hook order, exact #N, viewport scroll
Install
hermes plugins install claudioorjunior/hermes-github-prs --enableRequires Hermes Desktop + authenticated gh. Pane: titlebar GitHub → right workspace.
🇧🇷 Português (Brasil)
Release especial de UI. Headers preenchidos, trilho na conversation, checks compactos, commits em <details> lazy, diffs sem caixa, picker com avatar, jump-to-latest no viewport do Radix, busca #N exata, herança matte/glass.
Correções do #20: hook acima dos early-returns (crash de ordem), headerQ.data nas deps (remeasure no mount), filtro [data-radix-scroll-area-viewport], #42 ≠ #142.
hermes-github-prs v0.2.0
hermes-github-prs v0.2.0
PRs & Issues as a pane inside Hermes Desktop — session-aware, CI-aware, review-aware. No backend, just
gh.
Highlights
- Session-aware PR chip — finds the PR for your current branch and the last PR mentioned in chat
- CI & review dots —
passing / pending / failing+approved / changes / requiredon every row - Inline review threads — grouped by
in_reply_to_id, withfile:linechips and collapsible diff hunk - Full diff viewer — unified patch → structured rows (
hunk/add/del/ctx),A/D/M/Rbadge,+N −N - In-pane merge — squash / merge / rebase + delete-branch, without leaving Hermes
- Quote to chat — one click to cite any comment straight into the active session's composer
All data via host.request('shell.exec') + gh CLI. No server, no extra token.
What's new
Session-aware PR chip
- Resolves PR from two sources (priority):
git rev-parse --abbrev-ref HEAD+remote.origin.url→gh pr list --head <branch>, fallbacksession.historyscan for lastgithub.com/owner/repo/pull/N - Clickable chip
#123 titlewith state dot; skips trunk branches (main/master/dev/trunk)
CI & review dots — Issue #10
- CI from
statusCheckRollup: mergesCheckRun(status+conclusion) andStatusContext(state) →passing / pending / failing / none; failing wins over pending - Review from
reviewDecision→approved / changes / required / none - Two 6px dots per row with native
titletooltip, zero layout cost
Inline review threads — Issue #9
groupInlineThreads()groupsin_reply_to_id→ 30-thread cap, bodies never truncatedfile:linechip falls back tooriginal_linewhenlineis null (outdated diff)- Collapsed
<details> Diff contextper inline comment - One chronological timeline: reviews + issue comments + inline threads
Diff viewer — Issue #12
parsePatch()→ row model{type: hunk|add|del|ctx|meta, oldLine, newLine, text}FileDiffBlockwithA/D/M/Rstatus badge,+N −Nvia theme diff vars, auto-open <150 lines- Table with old/new line numbers + sign + monospaced code
In-pane merge — Issue #2
- Methods: Squash / Create merge commit / Rebase
- Checkbox: Delete branch after merging
- Exec:
GH_PROMPT_DISABLED=1 gh pr merge --squash|--merge|--rebase [--delete-branch](avoids TTY hang;--yesis unsupported) - Invalidates
pr-page,prs,session-gitqueries on success
Quote to chat — Issue #1
Quoteon every comment card →commentToChatText({login, timestamp, body, permalink})→ blockquote- Dispatches
hermes:composer-insert(mode: block,target: main) +hermes:composer-focusviasetTimeout(0)so composer focuses after click - Disabled with native tooltip when no active session
Under the hood
| Area | Detail |
|---|---|
| Big payloads | shBig / shJsonBig route through /tmp/*.raw → base64 → *.b64 and re-join in 3800-byte chunks with atob (ASCII-safe, never splits multi-byte); N+2 shell.exec round-trips; ponytail: to replace with file-read RPC when gateway cap is raised |
| API helpers | ghApi / ghApiBig / ghApiBigPaginated — compact REST via --jq, repoOk() validation, --paginate --slurp → flat() |
| Full bodies | Fix #8: full comment bodies via shBig instead of 700-char truncation |
| Markdown | mdBlocks / mdInline — GFM subset (headings, lists, task lists, tables, quotes, <details>, fences, hr, inline); raw HTML stripped; ponytail tag for full GFM when SDK ships markdown |
| Labels | LabelChip + labelTextColor() — W3C relative luminance threshold 140 picks black/white text on any GitHub label color |
| Layout | Radix ScrollArea display:table wrap fix — forced display:block !important inside .github-prs-pane so content reflows instead of clipping |
| Perf | Lists capped at 30 rows; paginated comments/files; queries with staleTime 10–60s; payloads chunked to stay under shell.exec 4k stdout cap |
Merged PRs in this release
- #16
feat: PR status indicators (CI/review) and inline review comments - #17
feat: render label chips, diff hunks, and in-pane merge action - #18
fix(merge): use GH_PROMPT_DISABLED instead of unsupported --yes flag - #8
fix: show full comment bodies instead of truncating - #7
feat: auto-switch pane repo to the active session's repo - #6
fix: auto-refresh PR/issue detail views - #4
feat: quote PR/issue comment into active session chat
Install & Use
gh repo clone claudioorjunior/hermes-github-prs
# Hermes → Capabilities → Install plugin (local)
# Requires: gh authenticated (gh auth login) + git repo with originPane: titlebar GitHub button → right workspace. PR chip: titlebar second. Detail: click any PR/Issue → tabs (Conversation / Commits / Files / Checks). External links via pluginCtx.os.openExternal.
🇧🇷 Português (Brasil)
PRs & Issues como um pane dentro do Hermes Desktop — consciente da sessão, do CI e do review. Sem backend, só
gh.
Destaques
- Chip de PR consciente da sessão — encontra o PR da sua branch + o último PR mencionado no chat
- Bolinhas de CI & review —
passing / pending / failing+approved / changes / requiredem cada linha - Threads inline — agrupadas por
in_reply_to_id, com chipfile:linee hunk colapsável - Diff viewer completo — patch unificado → linhas estruturadas (
hunk/add/del/ctx), badgeA/D/M/R,+N −N - Merge no pane — squash / merge / rebase + apagar branch, sem sair do Hermes
- Citar no chat — um clique para citar qualquer comentário no composer da sessão ativa
O que mudou (resumo técnico)
Mesmo conteúdo da seção inglesa acima — statusCheckRollup+reviewDecision → bolinhas, groupInlineThreads() com fallback original_line, parsePatch() → FileDiffBlock, GH_PROMPT_DISABLED=1 gh pr merge, hermes:composer-insert via setTimeout(0), shBig em base64 3800-byte chunks, GFM subset, labelTextColor() por luminância W3C, fix do display:table do Radix.
Instalação
gh repo clone claudioorjunior/hermes-github-prs
# Hermes → Capabilities → Install plugin (local)
# Requer: gh autenticado (gh auth login) + repo git com originMIT · Built with @hermes/plugin-sdk · host.request('shell.exec') + gh — no backend.



