Summary
nForma currently only supports macOS and Linux. Windows is explicitly listed as unsupported in the README and compatibility table. This issue tracks adding first-class Windows support.
Current state
- CI matrix:
ubuntu-latest + macos-latest only (ci.yml, ci-install.yml, release.yml)
package.json engines: >=18.0.0, no os restriction
- README: "Works on macOS and Linux." — Windows row says "No"
- Codebase: No
process.platform checks anywhere. Several bash scripts in scripts/ (release.sh, secret-audit.sh, publish.sh) assume Unix
Requirements
CI/CD (high priority)
Codebase fixes (expected)
Documentation
Acceptance criteria
- All three CI workflows pass on
windows-latest with Node 18, 20, 22
npx @nforma.ai/nforma installs and runs the TUI on Windows
- Sessions can spawn Claude Code inside the TUI on Windows
- Quorum agent MCP servers start and respond to health checks on Windows
Notes
The biggest risk is node-pty (native addon for terminal emulation in the TUI Sessions module). It requires Visual Studio Build Tools on Windows. Consider whether to make Sessions an optional feature on Windows or bundle a prebuilt binary.
Summary
nForma currently only supports macOS and Linux. Windows is explicitly listed as unsupported in the README and compatibility table. This issue tracks adding first-class Windows support.
Current state
ubuntu-latest+macos-latestonly (ci.yml, ci-install.yml, release.yml)package.jsonengines:>=18.0.0, noosrestrictionprocess.platformchecks anywhere. Several bash scripts inscripts/(release.sh, secret-audit.sh, publish.sh) assume UnixRequirements
CI/CD (high priority)
windows-latesttoci.ymltest matrix (Node 18, 20, 22)windows-latesttoci-install.ymlinstall test matrixwindows-latesttorelease.ymlpre-release test jobnpm run test:cipasses on Windowsnpm run test:tuipasses on Windows (blessed + node-pty compatibility)npm run test:installpasses on Windowsnpm run test:formalpasses on Windows (Java/TLA+/Alloy availability)Codebase fixes (expected)
path.join()/path.resolve()usage for hardcoded/separatorsscripts/with cross-platform alternatives (or skip on Windows)node-pty/blessed-xtermnative addon rebuild on WindowssecurityCLI won't exist)child_process.spawn) with Windows paths~/.claude/→%USERPROFILE%\.claude\)Documentation
Acceptance criteria
windows-latestwith Node 18, 20, 22npx @nforma.ai/nformainstalls and runs the TUI on WindowsNotes
The biggest risk is
node-pty(native addon for terminal emulation in the TUI Sessions module). It requires Visual Studio Build Tools on Windows. Consider whether to make Sessions an optional feature on Windows or bundle a prebuilt binary.