Skip to content

Releases

GitHermes v0.5.0 — footer update

Choose a tag to compare

@claudiumio claudiumio released this 13 Sep 05:13
8165679

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 gh via shell.exec.

poster


Highlights

  • One-tap Ask Hermes — any PR reviewed in one click, straight from the detail view
  • Branch in the footer — owner/repo · branch of 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 --enable

Requires 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

Choose a tag to compare

@claudiumio claudiumio released this 23 Aug 20:55
fa10525

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 gh via shell.exec.

poster


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: and label: work on both PR and issue lists, with clickable tokens
  • Keyboard list flow — / focuses search, Escape clears it, Enter opens 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 --enable

Requires 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

Choose a tag to compare

@claudiumio claudiumio released this 21 Aug 05:04

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 #N search. Still no backend — gh via shell.exec.

poster


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 keep file:line on a second line with a contained diff
  • Checks in the conversation — compact strip Blocked / Waiting / All passed via summarizeChecks (failures first, native StatusDot, 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 — FileDiffBlock header 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 when headerQ.data mounts so a cached convQ cannot leave atBottom === true and hide the button
  • Exact #N filter — numericListQuery(); #42 matches 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 --enable

Requires 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.

PRs: #19, #20. MIT · @hermes/plugin-sdk · só gh.

hermes-github-prs v0.2.0

Choose a tag to compare

@claudiumio claudiumio released this 20 Aug 03:32
ca8ca2b

hermes-github-prs v0.2.0

PRs & Issues as a pane inside Hermes Desktop — session-aware, CI-aware, review-aware. No backend, just gh.

poster


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 / required on every row
  • Inline review threads — grouped by in_reply_to_id, with file:line chips and collapsible diff hunk
  • Full diff viewer — unified patch → structured rows (hunk/add/del/ctx), A/D/M/R badge, +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>, fallback session.history scan for last github.com/owner/repo/pull/N
  • Clickable chip #123 title with state dot; skips trunk branches (main/master/dev/trunk)

CI & review dots — Issue #10

  • CI from statusCheckRollup: merges CheckRun (status + conclusion) and StatusContext (state) → passing / pending / failing / none; failing wins over pending
  • Review from reviewDecision → approved / changes / required / none
  • Two 6px dots per row with native title tooltip, zero layout cost

Inline review threads — Issue #9

  • groupInlineThreads() groups in_reply_to_id → 30-thread cap, bodies never truncated
  • file:line chip falls back to original_line when line is null (outdated diff)
  • Collapsed <details> Diff context per 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}
  • FileDiffBlock with A/D/M/R status badge, +N −N via 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; --yes is unsupported)
  • Invalidates pr-page, prs, session-git queries on success

Quote to chat — Issue #1

  • Quote on every comment card → commentToChatText({login, timestamp, body, permalink}) → blockquote
  • Dispatches hermes:composer-insert (mode: block, target: main) + hermes:composer-focus via setTimeout(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 origin

Pane: 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 / required em cada linha
  • Threads inline — agrupadas por in_reply_to_id, com chip file:line e hunk colapsável
  • Diff viewer completo — patch unificado → linhas estruturadas (hunk/add/del/ctx), badge A/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 origin

MIT · Built with @hermes/plugin-sdk · host.request('shell.exec') + gh — no backend.