# Paneflow v0.6.9

- Released: 2026-06-27T16:55:27Z
- URL: https://paneflow.dev/releases/v0.6.9
- GitHub: https://github.com/ArthurDEV44/paneflow/releases/tag/v0.6.9
- Previous release: v0.6.8
- Next release: v0.6.10

## Release notes

Highlights

Windows agent hooks now use a native commandWindows command, so Codex and compatible agents no longer route Paneflow hooks through bash or WSL on Windows.
This removes the repeated SessionStart, PreToolUse, and PostToolUse hook exited with code 1 failures seen on Windows machines without a WSL distribution.
Paneflow still writes the portable command field as the cross-platform fallback and ownership marker, so cleanup and stale-hook detection keep working across Codex, Claude-compatible runners, Grok, and other supported agent panes.

What changed
Windows hooks

Added a Windows-native hook command for Paneflow-managed matcher-group handlers.
The Windows override invokes paneflow-ai-hook.exe through cmd.exe /D /C, avoiding any dependency on bash, Git Bash, or WSL for supported runners.
Kept the existing command entry for cross-platform fallback behavior and for recognizing Paneflow-managed hooks during self-healing cleanup.
Extended the Windows Codex hook regression coverage to assert that generated handlers include commandWindows and preserve the hook event argument.
Adjusted the handler construction so Clippy stays clean on Windows, Linux, and macOS targets.

Release metadata

Bumped the workspace version from 0.6.8 to 0.6.9.
Added the Debian changelog stanza for 0.6.9-1.

Upgrade notes

Existing running agent sessions keep the hook configuration they were launched with. After upgrading, restart Paneflow and start a fresh agent session.
Windows users installing through the MSI can upgrade normally with paneflow-0.6.9-x86_64-pc-windows-msvc.msi.
If an older in-app update path is still stuck from a previous version, install the 0.6.9 MSI manually once.

Downloads

Windows x64: paneflow-0.6.9-x86_64-pc-windows-msvc.msi
macOS Apple Silicon: paneflow-0.6.9-aarch64-apple-darwin.dmg
Linux x86_64: AppImage, .deb, .rpm, and tar.gz
Linux aarch64: AppImage, .deb, .rpm, and tar.gz
Checksums and Minisign signatures are attached for release assets.

Validation

Local: cargo check --workspace
Local: cargo fmt --check
Local: cargo clippy --workspace -- -D warnings
Local: cargo test --workspace
Local targeted regression: cargo test -p paneflow-shim
Release workflow: https://github.com/ArthurDEV44/paneflow/actions/runs/28294955232
Published release assets: 32

Commits

b1edb31 fix(shim): route Windows hooks through native command
6d274d3 chore(release): bump version to v0.6.9
d8b1d2d fix(shim): satisfy cross-platform hook clippy

Full changelog: v0.6.8...v0.6.9