iamhyc · Nov 8, 2026 · Nov 8, 2026 · Nov 8, 2026 · Nov 8, 2026
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -87,6 +87,11 @@ jobs:
             target: x86_64-unknown-linux-gnu
             bin: hvolt
             archive: tar.gz
+          - key: linux-arm64
+            os: ubuntu-24.04-arm
+            target: aarch64-unknown-linux-gnu
+            bin: hvolt
+            archive: tar.gz
           - key: win32-x64
             os: windows-2022
             target: x86_64-pc-windows-msvc

diff --git a/.gitignore b/.gitignore
@@ -49,3 +49,9 @@ screenshot-*.jpeg
 # Local toolchain caches and virtualenvs (never committed).
 .cargo-home/
 .venv/
+
+# Agent-side notes: this repository is public and these describe a local
+# development setup, so they stay on the machine instead of in the tree.
+/HANDOFF.md
+/AGENTS.md
+/docs/agents/
diff --git a/AGENTS.md b/AGENTS.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,14 @@ versions may change the CLI surface.
 
 ## [Unreleased]
 
+### Changed
+
+- A prebuilt binary is published and installable for `linux-arm64`, built on a native arm64
+  runner. `install.sh` resolves `aarch64`/`arm64` to it and names the real support list when it
+  refuses a platform.
+- `@hvolt/cli-darwin-x64` is no longer declared. The launcher listed five platform packages
+  while the release built three, so an Intel Mac installed a package with no binary behind it.
+
 ## [26.0.0-9] — 2026-11-08
 
 ### Added

diff --git a/HANDOFF.md b/HANDOFF.md
diff --git a/docs/agents/clean-code.md b/docs/agents/clean-code.md
diff --git a/docs/agents/domain.md b/docs/agents/domain.md