Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

fix(audit): document Windows release artifact

AkitaOnRailsa3db6ee8b312
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 6b6a2043..6e22703c 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -161,6 +161,31 @@ jobs:
$hash = (Get-FileHash $zip -Algorithm SHA256).Hash.ToLower()
"$hash $zip" | Out-File -Encoding ascii "$zip.sha256"
+ - name: Smoke test release zip
+ shell: pwsh
+ run: |
+ $ErrorActionPreference = "Stop"
+ $zip = "ai-memory-windows-x86_64.zip"
+ $smoke = "dist/smoke-windows-zip"
+ Expand-Archive $zip -DestinationPath $smoke -Force
+ & "$smoke/ai-memory.exe" --version
+ foreach ($path in @(
+ "hooks",
+ "crates/ai-memory-cli/templates/config.default.toml",
+ "docs/install.md",
+ "docs/windows.md",
+ "README.md",
+ "LICENSE"
+ )) {
+ if (-not (Test-Path "$smoke/$path")) {
+ throw "Windows release zip missing $path"
+ }
+ }
+ $checksum = Get-Content "$zip.sha256" -Raw
+ if ($checksum -notmatch '^[0-9a-f]{64} ai-memory-windows-x86_64\.zip\r?\n?$') {
+ throw "Windows release zip checksum is not sha256sum format"
+ }
+
- uses: actions/upload-artifact@v4
with:
name: ai-memory-windows-x86_64
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 511de244..e681df32 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
+### Added
+- Tagged releases now publish a native Windows x86_64 zip artifact
+ (`ai-memory-windows-x86_64.zip`) with `ai-memory.exe`, hooks, default
+ config template, checksums, and Windows install docs, giving native
+ Windows agents a no-toolchain path to the fast direct-binary hook mode.
## [0.13.0] - 2026-06-08
### Added
diff --git a/README.md b/README.md
index b81e23fb..ce7ce4f5 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,7 @@
| Linux | Supported | Primary Docker/server target and CI platform. Published Docker images support `linux/amd64` and `linux/arm64`. Native Arch/AUR packages include system and user systemd units. |
| macOS | Supported | Workspace tests run in CI; native source builds are supported. Docker images run natively on Apple Silicon via the `linux/arm64` manifest. |
| Windows via WSL2 | Supported | Use the Linux install path inside WSL2 when the agent runs there. |
-| Native Windows | Experimental | PowerShell wrapper is available. Claude Code uses Git Bash `.sh` hooks on native Windows; other script-hook agents use the current PowerShell defaults pending harness feedback. See [`docs/windows.md`](docs/windows.md). |
+| Native Windows | Experimental | Tagged releases publish `ai-memory-windows-x86_64.zip` with `ai-memory.exe`; Docker Desktop wrapper and source builds are also available. Claude Code uses direct native `ai-memory.exe hook` commands by default; other script-hook agents use the current PowerShell defaults pending harness feedback. See [`docs/windows.md`](docs/windows.md). |
| Claude Code | Supported | MCP config + lifecycle hooks. |
| Codex | Supported | MCP config + lifecycle hooks. |
| OpenCode | Supported | Remote MCP config + generated TypeScript plugin. |
@@ -495,7 +495,7 @@ diagram, crate breakdown, schema notes, and invariants.
| [`docs/usage.md`](docs/usage.md) | Handoffs, proactive memory queries, routing snippet, web UI, raw-wiki inspection, and rules-vs-facts workflow. |
| [`docs/marker-file.md`](docs/marker-file.md) | `.ai-memory.toml` workspace/project routing for multi-client trees, mono-repos, worktrees, and work/personal separation. |
| [`docs/auto-scope.md`](docs/auto-scope.md) | `[auto_scope]` modes for shared servers: default single-slot routing, session-aware isolation, and multi-user `per_actor` behavior. |
-| [`docs/windows.md`](docs/windows.md) | Windows install modes: full WSL2, native Windows with Docker Desktop, native source builds, and current hook/MCP harness caveats. |
+| [`docs/windows.md`](docs/windows.md) | Windows install modes: full WSL2, native Windows with Docker Desktop, prebuilt native release zip, native source builds, and current hook/MCP harness caveats. |
| [`docs/mcp-install.md`](docs/mcp-install.md) | Per-client MCP and lifecycle notes (Cursor, Claude Desktop, Gemini CLI, Antigravity CLI, OpenClaw, OMP). |
| [`docs/deploy.md`](docs/deploy.md) | Homelab deploy: bin/deploy, bearer-token auth, pointers to the TLS guide. |
| [`docs/users.md`](docs/users.md) | **Multi-user attribution (v0.8).** Four-rung auth ladder, `ai-memory user add/list/expire/revive/rotate-token` walkthrough, backward-compat migration for pre-v0.8 installs, token storage rationale. |
diff --git a/docs/install.md b/docs/install.md
index bc01648a..a6fedd5e 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -624,9 +624,11 @@ The `serve` subcommand also accepts:
On Windows, see [`docs/windows.md`](windows.md). The short version: run
the install commands from the same environment that launches the agent.
-WSL2-launched agents need WSL paths and POSIX `.sh` hooks. Native Claude Code
-uses Git Bash `.sh` hooks with Windows paths converted to `/c/...`; other
-native Windows script-hook agents use PowerShell `.ps1` defaults.
+WSL2-launched agents need WSL paths and POSIX `.sh` hooks. Native Windows
+agents can use the tagged `ai-memory-windows-x86_64.zip`, the Docker Desktop
+wrapper, or a source build. Native Claude Code uses direct `ai-memory.exe hook`
+commands by default; other native Windows script-hook agents use PowerShell
+`.ps1` defaults.
When run from source, `install-hooks` finds the bundled scripts in
the repo's `hooks/` automatically: