Repository navigation
Code Flow v0.1.0-preview.5
Pre-release
Pre-release
Code Flow 0.1.0-preview.5
Run your installed coding agents in one local workspace. This is an early preview.
What changed
- Windows desktop preview for x64 and ARM64: the Electron window runs on Windows, while the backend and agents run in an initialized WSL2 distribution. Docker Desktop is not required.
- The app bundles a pinned Linux Node.js and npm runtime, reuses WSL agent logins, and keeps agents running when the window closes. Quit stops only this app's backend.
- Windows packaging now handles CRLF checkouts correctly, with checks for the executable, UI assets, archive contents and checksums. CI also tests the actual Windows-produced Linux runtime on Ubuntu.
- Includes the latest repository and worktree interface fixes, consistent subprocess state paths, and exclusion of temporary rebuild files from release packages.
Try the exact release
With Node.js 22.13+ and Git 2.38+ installed:
npx --yes --package=https://github.com/midhunxavier/code-flow/releases/download/v0.1.0-preview.5/midhunxavier-code-flow-0.1.0-preview.5.tgz codeflowThe app opens in your browser. Keep the terminal open and press Ctrl+C to stop. Install and sign in to at least one supported agent CLI before starting a run.
Installation channels
- npm: publishing this GitHub release automatically publishes the attached tarball and updates both
latestandpreview. After npm processing completes, usenpx @midhunxavier/code-flow@previewornpm install -g @midhunxavier/code-flow@preview. - macOS: choose the arm64 DMG for Apple Silicon or x64 for Intel. Drag Code Flow to Applications. Node is bundled; the app opens its own Electron window. Closing the window keeps agents working; use Code Flow → Quit to stop. Chrome or Edge is required for the shared browser. Files marked
unnotarizedare developer builds and macOS may block them. - Linux: use the npm launcher.
- Windows desktop: extract the unsigned portable ZIP and open Code Flow.exe with an initialized WSL2 distribution. Node is bundled; install Git and agent CLIs in WSL and sign in there. Docker Desktop is not required. This WSL2 preview still needs real Windows acceptance testing. The npm launcher remains available through WSL2.
- Homebrew: the attached
code-flow.rbis generated from the tarball checksum. Copy it toFormula/code-flow.rbin the maintainer's Homebrew tap before advertisingbrew install midhunxavier/code-flow/code-flow.
The Windows desktop stores history in ~/.codeflow-desktop/<installation-id>/state inside WSL. The npm launcher and macOS app use ~/.codeflow. History survives replacing the app. Read the Windows WSL2 setup guide or the installation guide.