You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This commit was created on GitHub.com and signed with GitHub’s verified signature.
Release Notes
Fixed (app launch)
The packaged app (.app/.dmg, and the bare binary when started from a
read-only directory) launched nothing with no error message. The
single-instance lock file was created relative to the working directory,
which is / when launched from Finder — unwritable, so startup aborted. The
lock now lives at an absolute path under the temp dir, and a lock-creation
failure no longer prevents the app from starting.
Install termherd-app 0.1.0-prerelease.4
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/bastien-gallay/termherd/releases/download/v0.1.0-prerelease.4/termherd-app-installer.sh | sh
This commit was created on GitHub.com and signed with GitHub’s verified signature.
Release Notes
Fixed
F-packaging-ci (Windows + Intel macOS): the desktop-installer workflow now
ships NSIS only on Windows — WiX/MSI rejects a non-numeric version, so the -prerelease.N suffix broke MSI packaging and failed the whole Windows job
(the NSIS *-setup.exe itself built fine). Intel macOS (x86_64-apple-darwin)
is now cross-compiled on an Apple-Silicon runner instead of the scarce macos-13 Intel runners, which were queueing for hours.
Install termherd-app 0.1.0-prerelease.3
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/bastien-gallay/termherd/releases/download/v0.1.0-prerelease.3/termherd-app-installer.sh | sh
This commit was created on GitHub.com and signed with GitHub’s verified signature.
Release Notes
Added
F-packaging-ci (desktop installers): GUI installer bundles to complement
the existing cargo-dist bare-binary pipeline. A cargo-packager config
([package.metadata.packager] in crates/app/Cargo.toml) plus a generated
app icon set (crates/app/icons/, all derived from icon.svg via generate.sh) and a new .github/workflows/package.yml build macOS .app/.dmg, Windows .msi/.exe (NSIS) and Linux .deb/.AppImage on a
per-target matrix and attach them to the GitHub Release that release.yml
creates (poll-then-upload, so the two workflows never race to create the
release). The macOS .app and .dmg paths are verified locally; bundles are
unsigned for now (signing/notarization pending certificates, OQ5). The README
gains an Install section.
F-plans-memory (M3, read-only first slice): browse and view Claude's plans
(~/.claude/plans/*.md) and memory files — the global ~/.claude/CLAUDE.md
and each project's CLAUDE.md — from a "Plans & mémoire" section in the
sidebar. Clicking one loads it off-thread and shows it read-only in the main
pane (✕ returns to the terminal); the doc list refreshes on each scan so
project memories appear once their paths are known. A new docs file adapter
lists and reads. Editing — and the ~/.claude write-scope change it needs —
is a deliberate follow-up.
F-session-metadata (M3): a star / archive / custom-title overlay on the
read-only Claude sessions, persisted to ~/.termherd/metadata.json (we never
write under ~/.claude). The browser pins starred sessions to the top of
their group, hides archived ones behind an "Afficher les archivées" toggle,
and shows custom titles. Star (★/☆) and archive (⊟/⊞) are per-row sidebar
buttons. The overlay is pure in core — SessionMeta, applied in visible_projects, behind ToggleStar / ToggleArchive / RenameSession / ShowArchivedToggled events that emit a SaveMetadata effect (default
entries are pruned, so a toggle-back leaves no noise). Renaming is inline: a
✎ button swaps the title for an edit field that commits on Enter (or ✓);
while it is open the field owns the keyboard, so terminal routing pauses.
F-keyboard-shortcuts (M3): a configurable keymap (FR9). Every shortcut is
now a KeyChord -> Action binding in core::keymap (pure, testable):
human chords ("ctrl+shift+c", order/case-insensitive) parse to a chord,
platform-aware defaults bind copy/paste/close/search (⌘ on macOS, Ctrl
elsewhere) plus Ctrl+Tab / Ctrl+Shift+Tab tab cycling, and the keys
section of settings.json overrides any action (one chord or a list).
Unknown actions and unparsable chords are logged and skipped. The shell
builds a chord from each key event and runs the bound action, so the
hard-coded clipboard chords are gone and keyboard tab switching, tab close
and search focus now work; split-* / focus-next/prev actions are bound
as those features land.
F-settings (M3, thin): user settings (FR10) persisted to ~/.termherd/settings.json. A shell profile (program + args) is injected
into the PtyManager so each session launches the chosen shell instead of
the platform default; a GUI theme (dark/light) dresses the iced chrome
(sidebar, tab strip, buttons) while the terminal grid keeps its own colours.
Every field defaults, so a missing or corrupt file still starts cleanly.
Window bounds keep their own window.json (FR12); an in-app settings panel
is the full version later, so for now the file is edited by hand.
F-builtin-terminal (M2): clipboard copy/paste shortcuts (FR4). Ctrl+V / Ctrl+Shift+V paste the clipboard into the focused PTY (previously only
copy-on-select existed, so there was no way to paste at all); the chord
shadows the raw ^V control byte, the Windows-terminal convention. Ctrl+Shift+C copies the current selection — plain Ctrl+C stays the
interrupt signal, as in every terminal. On macOS the Cmd key drives copy
(Cmd+C) and paste (Cmd+V) directly, leaving Ctrl free for the interrupt.
Multi-line paste is handled
correctly: newlines normalise to carriage returns, and when the application
has enabled bracketed paste (DECSET 2004, which the ptyScreen now
reports) the text is wrapped in ESC[200~…ESC[201~ so it lands as one
block instead of submitting line by line.
F-session-tabs (M3): open sessions are now navigable tabs, not just the
last-launched terminal. A tab strip above the terminal switches between
sessions; each chip carries its activity dot (the FR8 tab badge, folded to
the most urgent status of the sessions it hosts) and a close button. Closing
a tab kills its session's PTY — the first UI-driven Effect::Kill — and
drops the session from the live registry and its cached screen. The tab tree
edits are pure in core (Workspace::activate/close_tab, Tab::sessions, App::tab_status) behind Event::ActivateTab/CloseTab, exhaustively unit
tested; the shell only renders the strip and forwards clicks. Drag-reorder
(FR5) and keyboard tab-switching (F-keyboard-shortcuts) are not yet wired.
F-builtin-terminal (M2): the embedded terminal is now a real terminal.
The pty reader builds a Screen snapshot — the visible grid with per-cell
RGB (resolved from the xterm-256 palette), the cursor and a scrolled flag —
from alacritty_terminal's renderable content. The shell draws it on an
iced canvas (colour cells + cursor), routes raw keyboard to the focused
PTY (control combos, named keys, cursor sequences, layout text; gated by a
terminal/search focus model so the search box keeps its own typing),
propagates window resize to the PTY's cell geometry, and resumes a Claude
session with claude --resume <id> when a session row is clicked. Verified
end-to-end on Windows: clicking a session resumed a live Claude run inside
TermHerd, its OSC activity drove the badge, and keystrokes reached it.
F-builtin-terminal (M2, completed): wheel scrollback and drag-to-select
with copy-to-clipboard close out FR4. The pty adapter now runs a reader
thread (blocking PTY reads) feeding a terminal thread that owns the grid
and applies bytes / resize / scroll commands, so the viewport reacts to the
wheel immediately instead of waiting on the next PTY output. Selection is
tracked in the canvas, highlighted, and copied on release.
F-status-notifications (M2, completed for the current surfaces): the pty reader thread decodes each raw chunk with termherd_claude::osc before the bytes reach alacritty_terminal (which would consume the
sequences) and folds the markers into a per-session status, emitting PtyEvent::Status on change. Beyond busy/idle, an OSC 9 notification — a
permission prompt or an explicit "needs your attention" ping — now maps to
a distinct Attention status; it is sticky against a bare idle prompt (the
user still has to act) and cleared only when work resumes. The shell feeds
it to core (Event::StatusChanged) and surfaces it as a coloured badge on
the focused terminal and as a per-session dot in the sidebar (core now
records which Claude session each terminal resumed, so a browsed row shows
its live activity). Tab badges arrive with tabs (M3); the bell is decoded
but deliberately not treated as an activity status.
F-builtin-terminal (M2, in progress): termherd-pty adapter — one portable-pty PTY + alacritty_terminal grid per session, owned by its
own reader thread (actor-per-session, the structural fix for the realSessionId race, Q6). A PtyResponder replies to cursor-position
queries (ESC[6n), without which ConPTY never starts the child on
Windows. The headless core gained the terminal lifecycle — Event::LaunchSession/TerminalInput/TerminalResized/PtyExited and Effect::Spawn/Write/Resize/Kill over a monotonic SessionId
registry — and the iced shell performs those effects against the PtyHost port: clicking a project opens a terminal, its live screen
renders as monospace text with a line-input box. Verified end-to-end on
Windows ConPTY (spawn → reply → write → grid → kill) and visually in the
shell. Pending: raw key input, colours/cursor/selection, scrollback,
widget-driven resize.
Initial scaffold: Cargo workspace (core / claude / app), pinned
toolchain (1.95.0), MIT license, README, deny config.
F-app-shell (M0): iced 0.14 window shell (OQ1 settled on iced) —
placeholder view, window bounds persisted to ~/.termherd/window.json
on close and restored on launch (FR12); close requests intercepted so
bounds always save. The menu is deferred to M3: iced has no native menu
API, and the menu will mirror keymap actions (F-keyboard-shortcuts),
so they land together.
F-search (M1): in-memory search (FR3) — case-insensitive over titles,
summaries, slugs and indexed text, titles-only toggle; pure filter_projects in core behind Event::SearchChanged, search box +
checkbox in the sidebar.
F-session-browser (M1, completed): debounced notify watch on ~/.claude/projects (FR2) — bursts of fs events coalesce into one
rescan; the sidebar live-updates while Claude CLI writes. Verified
live: create/delete in the projects tree triggers a ~200 ms rescan.
F-session-browser (M1, first slice): termherd-scan adapter — walks ~/.claude/projects with upstream's exact derivation order (direct
JSONL, then session subdirs and subagents/), worktree collapse with
the fs existence check, underivable folders dropped like upstream but
logged; core::browser — pure grouping (one group per real path, FR1;
recen...
This commit was created on GitHub.com and signed with GitHub’s verified signature.
Release Notes
Added
F-plans-memory (M3, read-only first slice): browse and view Claude's plans
(~/.claude/plans/*.md) and memory files — the global ~/.claude/CLAUDE.md
and each project's CLAUDE.md — from a "Plans & mémoire" section in the
sidebar. Clicking one loads it off-thread and shows it read-only in the main
pane (✕ returns to the terminal); the doc list refreshes on each scan so
project memories appear once their paths are known. A new docs file adapter
lists and reads. Editing — and the ~/.claude write-scope change it needs —
is a deliberate follow-up.
F-session-metadata (M3): a star / archive / custom-title overlay on the
read-only Claude sessions, persisted to ~/.termherd/metadata.json (we never
write under ~/.claude). The browser pins starred sessions to the top of
their group, hides archived ones behind an "Afficher les archivées" toggle,
and shows custom titles. Star (★/☆) and archive (⊟/⊞) are per-row sidebar
buttons. The overlay is pure in core — SessionMeta, applied in visible_projects, behind ToggleStar / ToggleArchive / RenameSession / ShowArchivedToggled events that emit a SaveMetadata effect (default
entries are pruned, so a toggle-back leaves no noise). Renaming is inline: a
✎ button swaps the title for an edit field that commits on Enter (or ✓);
while it is open the field owns the keyboard, so terminal routing pauses.
F-keyboard-shortcuts (M3): a configurable keymap (FR9). Every shortcut is
now a KeyChord -> Action binding in core::keymap (pure, testable):
human chords ("ctrl+shift+c", order/case-insensitive) parse to a chord,
platform-aware defaults bind copy/paste/close/search (⌘ on macOS, Ctrl
elsewhere) plus Ctrl+Tab / Ctrl+Shift+Tab tab cycling, and the keys
section of settings.json overrides any action (one chord or a list).
Unknown actions and unparsable chords are logged and skipped. The shell
builds a chord from each key event and runs the bound action, so the
hard-coded clipboard chords are gone and keyboard tab switching, tab close
and search focus now work; split-* / focus-next/prev actions are bound
as those features land.
F-settings (M3, thin): user settings (FR10) persisted to ~/.termherd/settings.json. A shell profile (program + args) is injected
into the PtyManager so each session launches the chosen shell instead of
the platform default; a GUI theme (dark/light) dresses the iced chrome
(sidebar, tab strip, buttons) while the terminal grid keeps its own colours.
Every field defaults, so a missing or corrupt file still starts cleanly.
Window bounds keep their own window.json (FR12); an in-app settings panel
is the full version later, so for now the file is edited by hand.
F-builtin-terminal (M2): clipboard copy/paste shortcuts (FR4). Ctrl+V / Ctrl+Shift+V paste the clipboard into the focused PTY (previously only
copy-on-select existed, so there was no way to paste at all); the chord
shadows the raw ^V control byte, the Windows-terminal convention. Ctrl+Shift+C copies the current selection — plain Ctrl+C stays the
interrupt signal, as in every terminal. On macOS the Cmd key drives copy
(Cmd+C) and paste (Cmd+V) directly, leaving Ctrl free for the interrupt.
Multi-line paste is handled
correctly: newlines normalise to carriage returns, and when the application
has enabled bracketed paste (DECSET 2004, which the ptyScreen now
reports) the text is wrapped in ESC[200~…ESC[201~ so it lands as one
block instead of submitting line by line.
F-session-tabs (M3): open sessions are now navigable tabs, not just the
last-launched terminal. A tab strip above the terminal switches between
sessions; each chip carries its activity dot (the FR8 tab badge, folded to
the most urgent status of the sessions it hosts) and a close button. Closing
a tab kills its session's PTY — the first UI-driven Effect::Kill — and
drops the session from the live registry and its cached screen. The tab tree
edits are pure in core (Workspace::activate/close_tab, Tab::sessions, App::tab_status) behind Event::ActivateTab/CloseTab, exhaustively unit
tested; the shell only renders the strip and forwards clicks. Drag-reorder
(FR5) and keyboard tab-switching (F-keyboard-shortcuts) are not yet wired.
F-builtin-terminal (M2): the embedded terminal is now a real terminal.
The pty reader builds a Screen snapshot — the visible grid with per-cell
RGB (resolved from the xterm-256 palette), the cursor and a scrolled flag —
from alacritty_terminal's renderable content. The shell draws it on an
iced canvas (colour cells + cursor), routes raw keyboard to the focused
PTY (control combos, named keys, cursor sequences, layout text; gated by a
terminal/search focus model so the search box keeps its own typing),
propagates window resize to the PTY's cell geometry, and resumes a Claude
session with claude --resume <id> when a session row is clicked. Verified
end-to-end on Windows: clicking a session resumed a live Claude run inside
TermHerd, its OSC activity drove the badge, and keystrokes reached it.
F-builtin-terminal (M2, completed): wheel scrollback and drag-to-select
with copy-to-clipboard close out FR4. The pty adapter now runs a reader
thread (blocking PTY reads) feeding a terminal thread that owns the grid
and applies bytes / resize / scroll commands, so the viewport reacts to the
wheel immediately instead of waiting on the next PTY output. Selection is
tracked in the canvas, highlighted, and copied on release.
F-status-notifications (M2, completed for the current surfaces): the pty reader thread decodes each raw chunk with termherd_claude::osc before the bytes reach alacritty_terminal (which would consume the
sequences) and folds the markers into a per-session status, emitting PtyEvent::Status on change. Beyond busy/idle, an OSC 9 notification — a
permission prompt or an explicit "needs your attention" ping — now maps to
a distinct Attention status; it is sticky against a bare idle prompt (the
user still has to act) and cleared only when work resumes. The shell feeds
it to core (Event::StatusChanged) and surfaces it as a coloured badge on
the focused terminal and as a per-session dot in the sidebar (core now
records which Claude session each terminal resumed, so a browsed row shows
its live activity). Tab badges arrive with tabs (M3); the bell is decoded
but deliberately not treated as an activity status.
F-builtin-terminal (M2, in progress): termherd-pty adapter — one portable-pty PTY + alacritty_terminal grid per session, owned by its
own reader thread (actor-per-session, the structural fix for the realSessionId race, Q6). A PtyResponder replies to cursor-position
queries (ESC[6n), without which ConPTY never starts the child on
Windows. The headless core gained the terminal lifecycle — Event::LaunchSession/TerminalInput/TerminalResized/PtyExited and Effect::Spawn/Write/Resize/Kill over a monotonic SessionId
registry — and the iced shell performs those effects against the PtyHost port: clicking a project opens a terminal, its live screen
renders as monospace text with a line-input box. Verified end-to-end on
Windows ConPTY (spawn → reply → write → grid → kill) and visually in the
shell. Pending: raw key input, colours/cursor/selection, scrollback,
widget-driven resize.
Initial scaffold: Cargo workspace (core / claude / app), pinned
toolchain (1.95.0), MIT license, README, deny config.
F-app-shell (M0): iced 0.14 window shell (OQ1 settled on iced) —
placeholder view, window bounds persisted to ~/.termherd/window.json
on close and restored on launch (FR12); close requests intercepted so
bounds always save. The menu is deferred to M3: iced has no native menu
API, and the menu will mirror keymap actions (F-keyboard-shortcuts),
so they land together.
F-search (M1): in-memory search (FR3) — case-insensitive over titles,
summaries, slugs and indexed text, titles-only toggle; pure filter_projects in core behind Event::SearchChanged, search box +
checkbox in the sidebar.
F-session-browser (M1, completed): debounced notify watch on ~/.claude/projects (FR2) — bursts of fs events coalesce into one
rescan; the sidebar live-updates while Claude CLI writes. Verified
live: create/delete in the projects tree triggers a ~200 ms rescan.
F-session-browser (M1, first slice): termherd-scan adapter — walks ~/.claude/projects with upstream's exact derivation order (direct
JSONL, then session subdirs and subagents/), worktree collapse with
the fs existence check, underivable folders dropped like upstream but
logged; core::browser — pure grouping (one group per real path, FR1;
recency ordering) behind Event::ScanCompleted; the shell scans off
the UI thread at startup (FR2, initial scan only) and renders the
sidebar. Live notify updates and FTS search still to come in M1.
F-packaging-ci (M0, unsigned): cargo-dist 0.32 release pipeline —
tag-triggered GitHub workflow building mac (ARM + x64), Linux
(x64 + ARM) and Windows artifacts with shell/PowerShell installers and
checksums. Windows artifact verified locally (10.6 MB binary vs the
Electron app's ~150 MB). Signing/notarization pending certificates
(OQ5).
First TDD targets:
termherd-core::workspace — pane tree + tabs with unit tests
(open / split / focus).
termherd-claude::path — encode_project_path, byte-faithful port of
the JS reference, with unit tests.
