Windows support

[MasonStation]

Tracking issue for Windows platform support.

Status — functionally complete on main

Windows is shipped and exercised on every PR. Latest release is v0.5.1; PRs landing #9 and #10 (clipboard auto-clear + pre-commit hook docs) are in-flight via #44, after which Windows is fully on parity.

Shipped

• PR Windows support: blockers to compile (#2-#5) #14 (2026-04-21) — Rust workspace compiles on Windows; test suite green on windows-latest
• PR Windows: cross-platform home_dir lookup (#8, #13) #16 (2026-04-22) — cross-platform home_dir() via dirs crate
• PR Windows: cross-platform clipboard + daemon spawn (#6, #7) #17 (2026-04-22) — arboard clipboard + DETACHED_PROCESS | CREATE_NO_WINDOW daemon spawn
• PR npm: unblock Windows install path in wrapper (#15) #18 (2026-04-22) — npm wrapper Windows install path unblocked
• PR v0.5.1: Windows polish (shell syntax, README) #22 (2026-04-22) — v0.5.1 Windows polish (shell-syntax env-var printing, README)
• PR fix(cli): Windows final-mile cleanup — clipboard auto-clear + hook docs (closes #9, #10) #44 (open) — pure-Rust clipboard auto-clear via hidden __clear-clipboard-after subcommand + pre-commit hook caveat in README

Sub-issues

Done

• vault: add windows-native feature to keyring dependency #2 — keyring windows-native feature
• cli: replace which shell-out with cross-platform lookup #3 — cross-platform which lookup
• cli: add Windows taskkill path for phantom stop #4 — Windows taskkill for phantom stop
• cli: replace libc::isatty() with cross-platform TTY detection #5 — std::io::IsTerminal in place of libc::isatty
• cli: add Windows clipboard support for phantom reveal --copy #6 — Windows clipboard via arboard
• cli: add Windows daemon spawn path for phantom start #7 — Windows daemon spawn (DETACHED_PROCESS + CREATE_NO_WINDOW)
• vault: replace $HOME fallback with cross-platform home dir #8 — vault home_dir()
• ci: add windows-latest to test matrix #11 — windows-latest in CI matrix
• docs: add Windows setup section to README #12 — README Windows setup section
• cli: use dirs::home_dir() instead of $HOME in setup #13 — setup home_dir()
• npm: unblock Windows install path in wrapper package #15 — npm wrapper Windows install path
• cli: print shell-specific env-var syntax for phantom start #21 — shell-specific env-var syntax for phantom start

In flight (#44)

• cli: replace bash -c 'sleep && pbcopy' clipboard auto-clear with pure Rust #9 — clipboard auto-clear cross-platform — replaced bash -c 'sleep 30 && pbcopy' with a hidden __clear-clipboard-after subcommand spawned via current_exe(). Closes when fix(cli): Windows final-mile cleanup — clipboard auto-clear + hook docs (closes #9, #10) #44 merges.
• init: make pre-commit hook work under native Windows git #10 — pre-commit hook under native Windows git — documented in README's Windows section (Git for Windows ships sh.exe; GUI clients with stripped PATH may skip the hook). Closes when fix(cli): Windows final-mile cleanup — clipboard auto-clear + hook docs (closes #9, #10) #44 merges.

After #44

Once #44 merges:

1. Close cli: replace bash -c 'sleep && pbcopy' clipboard auto-clear with pure Rust #9, init: make pre-commit hook work under native Windows git #10
2. Close this tracker
3. Cut v0.5.2 with the final Windows polish included; npm publish from npm/ so the Windows path is current on the registry.

Open follow-ups (not blockers)

• Windows-on-ARM64 binary not yet packaged — x64 only.