Skip to content

feat(cli): hyperframes open hands the project to the app on Windows and Linux too - #6484

Merged
miguel-heygen merged 1 commit into
mainfrom
feat/cli-open-in-app-win-linux
Oct 26, 2026
Merged

miguel-heygen merged 1 commit into
mainfrom
feat/cli-open-in-app-win-linux

Conversation

@miguel-heygen

@miguel-heygen miguel-heygen commented Oct 26, 2026 •

Copy link
Copy Markdown
Collaborator

What

hyperframes open <dir> (and the app line render and preview print) now works on Windows and Linux. HANDOFF_READY, which was true only on macOS, is true everywhere. The folder is passed on the app's command line, the path the CLI already took on those platforms once the gate opened.

Why

Windows and Linux CLI users were shown the app download but their project never opened in it: the gate kept every surface on "download" and wrote no hand-off. The app already takes a folder on its command line on both platforms (macOS sends open-file), so the gate no longer protects anyone.

Why under 100 lines

Windows launch fix, separate failure (the project never opens in the app), ships alone; the app already takes the folder, so nothing else has to land with it.

Tests

Two new cases in desktopApp.test.ts, one per platform, that call openInDesktop with no ready override: the Windows install path and the Linux AppImage each receive the folder and the result is opened: true. Both fail with the gate closed (2 failed, 28 passed) and pass here (39 in desktopApp and desktopRoutes).
Not run against a real Windows or Linux app install.

@github-actions

Copy link
Copy Markdown
Contributor

Edit accuracy: accurate 271 (base branch 271), smooth 142 of those

The gate passes.
Smoothness is reported in the artifact, not gated. A case fails only if it fails 2 of 3 runs.

Quarantined, measured but not gated (0)

Unstable (1)

  • seqplainkeys-none-pct-r0-nested-z100: tracking 0.05, pressJump 0, drop 0, reload 0, render 0.02, renderKey -, undo false, teleport true / tracking 0.05, pressJump 0, drop 0, reload 0, render 0.02, renderKey -, undo true, teleport true / tracking 0.05, pressJump 0, drop 0, reload 0, render 0.02, renderKey -, undo true, teleport true

@heygengenesis heygengenesis Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verdict: APPROVE · 0 blocker · 1 important · 0 nits · head aa12b154

I checked the app side. hyperframes-internal#2687 is merged, and folderInArgv is still on main: it handles both the first launch and second-instance, and it requires an absolute path, which resolveProject gives. The NSIS InstallDir is $LOCALAPPDATA\Programs\<name>, which matches desktopApps. CI passed on this head.

  • important: Linux .deb installs are not found. desktopApps only reads launcher.json, and the app writes it only when APPIMAGE is set (folderArg.mjs writeLauncher). The .deb, which is what /studio/download serves to Linux browsers by default (osOf → deb), installs to /opt/<pkg>/<name> with a /usr/bin symlink and never writes that file. So a .deb user who runs hyperframes open is told "The HyperFrames desktop app isn't installed on this computer" and gets the AppImage link. Those users already got the download before this PR, so this is not a regression, but the PR's "works on Linux" covers AppImage only. Follow-up: also look for /opt/<pkg>/<name> (or /usr/bin/<pkg>) on Linux, or have the app write launcher.json for the .deb too.

— Claude

@miguel-heygen
miguel-heygen added this pull request to the merge queue Oct 26, 2026
Merged via the queue into main with commit be4e2e7 Oct 26, 2026
160 checks passed
@miguel-heygen
miguel-heygen deleted the feat/cli-open-in-app-win-linux branch October 26, 2026 23:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant