Skip to content

macOS/Herdr verification via SSH ​

Status: PASS for the installed package, the macOS fake E2E, and the full macOS checklist. No checklist item is unrun. Host-level notes remain: Herdr prefix ownership is inconclusive, and Ghostty copy-on-select is off so automatic copy-on-release is not claimed. Date: 2026-11-16 (first pass); re-verified 2026-11-16/17 Ticket: #277 Parent spec: #268 Prerequisites: #270 clean-install record, #279 built-package record Branch: ticket/277-macos, re-verification merge of integration/public-release at 70f3da7 (fixes #281, #282, #283, #284)

This record covers the macOS host only. It installs the built @heyimteee/ensemble@0.1.0-rc.2 package through opencode plugin add into an isolated HOME/XDG root, runs the installed TUI inside Herdr in Ghostty, drives the checklist with Ghostty AppleScript, and runs the deterministic fake E2E and size matrix from a clone of the release tag. It does not use a public npm publish, a real model, a real workspace, or the user's OpenCode configuration.

Environment ​

ItemValue
HostMacBook Pro, Apple silicon, arm64
macOS27.2.1 (build 26B131)
Terminal hostHerdr 0.9.5 inside Ghostty 1.4.0
Herdr sessionprefix ctrl+s, tab bar top, mouse-native, no sound; toasts through Herdr
Ghostty themeGruvbox Dark Hard, background #010101 at 0.4 with blur
Ghostty fontJetBrainsMono Nerd Font Mono, 13 pt
OpenCode2.2.7 (npm @opencode/cli, run via the nvm Node 26.12.1 bin)
Node26.12.1
npm11.21.1
tmux3.5a (used only by the repo fake harness and size matrix)
fd10.4.2
git2.56.0
Package@heyimteee/ensemble@0.1.0-rc.2
Tagrc-0.1.0-rc.2 at d74fc3d
Isolationfresh HOME, XDG config/data/state/cache, mock project, mock agents and skills under a temporary root

No host name, user name, home path, package-cache path, credential, clipboard content, or conversation content is recorded.

Re-verification method (2026-11-16/17) ​

The three fixed failures were re-checked without any screen access while the user was on a video call:

  • Host access was SSH only. Commands ran in a detached tmux session on a private socket (tmux -L ensemble277) at 140×50. Nothing was attached to the user's terminal, tabs, or frontmost app.
  • The TUI was read with tmux capture-pane -p (text) and tmux capture-pane -p -e (text + ANSI). State came from the isolated service's RPC snapshot and from filesystem reads.
  • No screenshots of any kind were taken (screencapture was not run and no image file was created), no AppleScript / System Events / osascript was used, no Herdr command was issued, and no pointer or mouse input was sent. There were no focus changes and no keystrokes to the frontmost app. Keys went only to the detached pane (tmux send-keys).
  • The user's OpenCode config, service, clipboard, and processes were not touched. The previous isolated HOME/XDG roots were reused; the installed package cache was refreshed from the branch build at 70f3da7 with npm pack, the loopback registry, and opencode plugin add. The server log loads dist/server.js from the isolated package cache. The candidate was 507,243 bytes with 121 built JS files.
  • tmux stores colors as 256-color indices; the terminal-default intent (39/49) survives unchanged, and the sequences quoted below are the ones capture-pane recorded before the terminal applied them.

The first-pass method below is historical. It used Ghostty AppleScript and window screenshots; none of that was used in this re-verification.

1.7 mouse selection was completed in a separate real Herdr/Ghostty session on 2026-11-17 and is recorded from the host results: Shift+drag over the composer marker, explicit copy_to_clipboard, mode/focus unchanged. This docs-only record update ran no Mac commands, screenshots, or pointer input; automatic copy-on-release is not claimed because Ghostty copy-on-select is off.

First-pass method and limits (2026-11-16) ​

  • Ghostty AppleScript is the real input path: send key <name> [modifiers "control,..."] and input text <text> to the focused terminal of the selected tab of the front window. The disposable Herdr tab ensemble-macos-test (w1:tD, pane w1:p16) was used for every check.
  • The tab ran at its normal 84×64 grid for the installed-smoke and compact layout, then at 196×64 after perform action "toggle_fullscreen" on the Ghostty terminal for the full Work-card/tide and reduced-motion checks. The window was restored to 84×64 afterwards.
  • A Herdr split pane ran screencapture -l <Ghostty window id>, so TCC was inherited from Ghostty. The window id came from a small Swift CGWindowListCopyWindowInfo probe. Screenshots were window-only, inspected, and deleted on both hosts. One initial whole-display capture was deleted and is not used here; subsequent captures were restricted to the Ghostty window.
  • herdr pane read is unreliable for OpenCode's alternate screen: it can return old scrollback or a stale statusline. Key results below use the visible screenshot, herdr pane read --format ansi --raw, the service snapshot, or the scripted fake E2E; a pane read miss is not treated as a product failure.
  • Mouse selection used Ghostty AppleScript send mouse position x <px> y <px> and send mouse button left button action press|release. The commands returned success at physical, point, cell, and pane-relative coordinates derived from the window-only screenshot (marker text bbox x=1526..1857, y=503..523), but no selection/copy occurred. This failed helper method was superseded by the real Shift+drag session on 2026-11-17; details are under 1.7.
  • Global window-manager hotkeys are not claimed. The 1.7 mouse selection is pane-bounded and was repeated in a real Herdr/Ghostty session.

Install command and result ​

The Git RC spec fails, but this is an OpenCode/Bun upstream limitation, not an Ensemble defect. The same failure occurred for github:..., git+https://…, and owner/repo#tag specs with OpenCode 2.2.7:

sh
opencode plugin add github:heyimteee/ensemble#rc-0.1.0-rc.2
text
NpmInstallFailedError: Failed to install ...: git dep preparation failed
ERRORS
  Unrecognized flag: --force in command opencode
  Unrecognized flag: --cache in command opencode
  ...
  Unrecognized flag: --no-dry-run in command opencode

No config was written. Do not recommend Git installs for this host. The supported RC channel is the npm package or the loopback registry:

sh
# loopback-only registry serving the packed candidate
opencode plugin add @heyimteee/ensemble@0.1.0-rc.2

The install check packs @heyimteee/ensemble@0.1.0-rc.2 (124 files, 121 built JS files, 503,985 bytes on macOS), serves it on 127.0.0.1, and records the package in the isolated config. opencode plugin list:

text
ID           VERSION     SOURCE
ensemble.v2  0.1.0-rc.2  @heyimteee/ensemble@0.1.0-rc.2

The installed server loaded from the package cache, not the checkout:

json
{"id":"ensemble.v2","source":{"type":"package","target":"@heyimteee/ensemble@0.1.0-rc.2","version":"0.1.0-rc.2"},"features":{"server":true,"tui":true,"rpc":true},"state":{"status":"active"}}
text
msg="loading plugin" id=@heyimteee/ensemble@0.1.0-rc.2
entrypoint=file://<package-cache>/dist/server.js role=server

One real host turn through the installed plugin reported ensembleToolCount: 6, the native Ensemble toolset.

Installed TUI and Herdr detection ​

  • PASS /ensemble loads the installed route. Screenshots showed ENSEMBLE | #HerdrCheck | <mock-project>, 1 workspaces · 2 agents, the WORK ACTIVE header, the inline HerdrLeader | LEADER label, and the NORMAL | Agents statusline with native:live.
  • PASS the route renders in Herdr/Ghostty at 84×64 (compact layout) and at 196×64 (full layout).
  • PASS Herdr detects the installed TUI as an agent: agent=opencode, terminal title OpenCode, agent_status=idle while attached and unknown when idle/unclassified. agent_session was not populated (no session id); the pane returned to an empty agent field after the TUI exited.

Manual checklist ​

PASS via fake means the row was observed in the macOS deterministic fake E2E, not repeated by hand in Herdr. NOT RUN is not a pass.

SectionResultEvidence / notes
1. Shortcuts and key ownershipPASS1.1–1.5 PASS via Ghostty AppleScript: j, Enter, ?, Space, Esc, Space q, native text, / native menu, F2, :q, prose :. 1.6: Ctrl+G from composer Normal leaves to `NORMAL
2. System Agent streamingPASSFake E2E I, :init, /init produced one visible audit line each, a running System Agent row, three Ensemble init complete reports, and AGENTS.md/init.json writes. The installed Herdr TUI's :init also succeeded on the main workspace with the detached fake provider (initJobs succeeded).
3. Palette behaviorPASS via fakeFake E2E covers Command / `Skill
4. Init lifecycle and writes4.4/4.5/4.6a PASS; 4.6b PASS (re-verified)First pass: 4.4 PASS (native /init produced native instructions; initJobs stayed 0), 4.5 PASS (init_running; one job/report; files written), 4.6a PASS (archive restored the prior file). First-pass 4.6b FAIL: the block plus PRIOR_RESTART_277 remained while the report claimed restoration. Re-verified after #281 in the isolated install (SSH + detached tmux + RPC/filesystem): with a prior CRLF AGENTS.md, the service was frozen at the block write and SIGKILLed mid-init; after restart the job settled interrupted with report="Ensemble init was interrupted by a service restart.\nAGENTS.md was restored to its previous content.\nRerun /init to try again.", restorePending=false, AGENTS.md byte-identical (cmp) to the prior content, and .ensemble/init.json absent. With no prior file: report="...AGENTS.md was removed because it did not exist before init...", AGENTS.md absent, init.json absent. A SIGTERM variant completed init before shutdown and is not counted as a mid-run kill.
5. v6 Braille and Sub-Cell TidePASS (fallback) with font findingFullscreen ANSI captures contain Braille frames (for example ⠙/⠋) and all tide levels ▁▂▃▄▅▆▇█; the screenshot shows a rendered spinner, not tofu. The configured JetBrainsMono Nerd Font Mono Regular face's cmap has 0/256 U+2800–U+28FF Braille codepoints but 8/8 U+2581–U+2588 block levels; terminal fallback supplies Braille. Fake E2E verifies all ten frames and tide at 160×80. A terminal without a Braille fallback would show tofu.
6. v6 Work cards and recent cardsPASS; 6.3 PASS by macOS tmux matrixHerdr at 84×64 showed compact rows; at 196×64 the full layout. Fake E2E covers anatomy, ordering, actions, recent cards at 160×80. Exact sizes: ENSEMBLE_V6_SKIP_LOAD=1 bash scripts/live-size-matrix.sh PASS on macOS/tmux for 80×24, 100×30, 120×40 (compact rows, no card borders) and 160×50 (4 full-width one-card rows); fixture cancel/focus/budget/borders passed at each. The 160×50 load probe was skipped because find_tui_pid/tui_cpu_ticks use Linux /proc; the exact failure is live: could not resolve the TUI opencode process.
7. v6 app-owned toastPASSHerdr screenshot shows the app-owned Message sent transient with mode/focus unchanged; fake E2E verifies the Clipboard toast is top-right, auto-dismisses, and does not take keys.
8. v6 reduced motion and NO_COLOR8.1 PASS; 8.2 PASS (re-verified after #282 and #284)First pass: ENSEMBLE_REDUCED_MOTION=1 frames 1.2 s apart kept only ⠋ and a still tide; no blink glyph. NO_COLOR=1 kept motion frozen and state text. #282 fixed the Work-pane palette: the Work-card header is default foreground (\x1b[39m...⠋ WORKING) with no background SGR, Work-pane borders and box glyphs are \x1b[39m/default, the statusline chip is \x1b[1m\x1b[39m NORMAL \x1b[0m, no 48; background appears in the Work pane, and every target Work-pane cell reports fg=default bg=default. #284 fixed the transcript: the agent author and all Markdown scopes resolve to default foreground with no background under NO_COLOR. A live silent detached-tmux ANSI capture showed no 38;5, 48;5, 38;2, or 48;2 sequences on visible transcript text; only host canvas filler spaces emit 38;2;255;255;255. A control run without NO_COLOR kept the colors. Text/glyph distinctions remain: ⠋, WORKING, HERDRLEADER, the task title, and the tide levels are present.
9. v7 dispatch groups and treatments9.1/9.2/9.6 PASS; 9.8 PASS (re-verified)First pass showed `WORK ACTIVE

Re-verification evidence (2026-11-16/17) ​

All re-check evidence came from a detached pane, RPC, or the filesystem; no screen or window was read.

4.6b (#281). RPC workspace.create + workspace.init, then a busy-wait for the AGENTS.md write; kill -STOP the service the moment the write landed (so the job was still writing with restorePending), kill -KILL, restart, and wait for the snapshot. Assertions: cmp AGENTS.md <prior> (CRLF preserved), test ! -e .ensemble/init.json, and the initJobs report. Both a prior-file workspace and a no-prior-file workspace passed; the no-prior workspace also checked test ! -e AGENTS.md. The exact reports are in the row 4 evidence.

8.2 (#282, #284). NO_COLOR=1 TUI in the detached pane with one working card; tmux capture-pane -p -e was parsed per cell. #282 made the Work-card header, Work-pane borders, statusline chip, and backgrounds default foreground/no background. #284 made the agent author and all Markdown scopes default foreground/no background; a live silent detached-tmux ANSI capture of visible transcript text found no 38;5, 48;5, 38;2, or 48;2; only host canvas filler spaces emit 38;2;255;255;255. A control run without NO_COLOR kept the colors. No screenshots, Herdr commands, pointer input, or focus changes were used.

9.8 (#283). Delegate fake-lease-hold; capture the TUI; kill -KILL the service; wait until the loopback listener is gone; restart with the same password; capture every 0.5 s without sending any key to the pane; compare RPC snapshots before/after. The interrupted-row screen appeared on the second 0.5 s capture after the restarted service became ready; the HerdrLeader · interrupted row and the durable GROUP 1/card were present, with one group header and one card. The RPC snapshot still lists the old row as streaming: true; marking it interrupted is client-side, as designed.

Herdr prefix observation ​

The prefix check is inconclusive host-level evidence, not a checklist FAIL. Sending ctrl+s then c through Ghostty AppleScript produced no tab or pane at the before/after check; the pane shell received Ctrl+S (XOFF) and needed Ctrl+Q. A stray tab labelled c/ensemblec5 appeared later and was closed. The user's independent run with ctrl+s, ctrl+a, and ctrl+b + c, after herdr server reload-config, with Ghostty frontmost and both Ghostty AppleScript and real System Events keystrokes, also produced no tab or pane. None of Ensemble's documented keys were intercepted.

Fake E2E and size matrix ​

From a clone of tag rc-0.1.0-rc.2 with the fixes on this branch:

sh
ENSEMBLE_LIVE_REQUIRE=1 bash scripts/live-check-fake.sh           # PASS
ENSEMBLE_LIVE_REQUIRE=1 bash scripts/live-check-fake-empty.sh     # PASS
ENSEMBLE_LIVE_REQUIRE=1 ENSEMBLE_V6_SKIP_LOAD=1 \
  bash scripts/live-size-matrix.sh                                 # PASS

The first full fake attempts failed at the doctor check with an empty output. Root cause: doctor-cli.ts compared import.meta.url with the raw process.argv[1] path; on macOS /tmp is a symlink to /private/tmp, Node resolved the module URL to the real path, the guard was false, and the CLI exited 0 without running main(). The fix compares real paths and adds a symlink regression test (src/v2/doctor-cli.test.ts). The live harness also canonicalizes its isolated base path with pwd -P so host-reported paths compare equal under the macOS /var symlink.

Follow-ups ​

Fixed and re-verified with no open follow-up: 4.6b (#281), 8.2 (#282 and #284), and 9.8 (#283).

  1. OpenCode 2.2.7 Git installs fail upstream. github:, git+https://…, and owner/repo#tag all fail during git dependency preparation with npm flags sent to opencode. This is not Ensemble-specific; do not recommend Git installs. Use the npm package or the loopback registry.
  2. Herdr prefix ownership remains inconclusive host-level evidence, not a checklist FAIL. The independent re-test with ctrl+s, ctrl+a, and ctrl+b
    • c, after herdr server reload-config, Ghostty frontmost, and real System Events keystrokes produced no tab or pane; none of Ensemble's documented keys were intercepted.
  3. 1.7 mouse selection is PASS; automatic copy-on-release is a host note. The real Herdr/Ghostty session used Shift+drag and an explicit copy_to_clipboard; mode/focus stayed unchanged. Ghostty copy-on-select is off, so a drag alone does not copy and automatic copy-on-release is not claimed. This is a host preference, not Ensemble behavior.
  4. Size-matrix load probe is Linux /proc-only; the exact sizes pass with ENSEMBLE_V6_SKIP_LOAD=1, but the load probe is not measured on macOS.
  5. Braille font coverage. The configured face has no Braille codepoints; the terminal fallback rendered the glyph. Add a Braille-capable font to the host requirements or state the fallback dependency.

Skips ​

  • No public npm publish and no registry credential.
  • No real model or workspace; the fake provider supplied every turn.
  • Herdr global hotkeys/window-manager behavior is not claimed. The 1.7 mouse selection is pane-bounded; automatic copy-on-release is not claimed.
  • The docs-only record updates used no Mac commands, screenshots, or pointer input. 1.7 is recorded from the real pointer session; automatic copy-on-release is not claimed because Ghostty copy-on-select is off.
  • The re-verification did not rerun the full fake E2E or size matrix; those PASS results are from the first pass. It also used no Herdr command.

Released under the MIT License.