Skip to content

feat: Add open-url to deliver an app link to one workspace's instance - #4

Merged
maximkrouk merged 1 commit into
mainfrom
feat/open-url
Nov 14, 2026
Merged

maximkrouk merged 1 commit into
mainfrom
feat/open-url

Conversation

@maximkrouk

Copy link
Copy Markdown
Member

Summary

Adds fxcodex open-url <workspace> <url>. It delivers an app link, such as a sign-in callback, to one workspace's Codex instance only (DEV-860).

  • Running instance: the link goes to its process as a kAEGetURL Apple Event addressed by process ID, the same event Launch Services sends.
  • Not running: that workspace's Codex launches with its own CODEX_HOME, profile and the link.
  • Routing: the link never goes through Launch Services' scheme routing, so other workspaces never see it.
  • Schemes: only the ones the installed Codex registers in CFBundleURLTypes (codex today); http/https are rejected.
  • --json returns the workspace, process ID and delivery (apple-event or launch).
  • Errors give a non-zero exit with a one-line message.

Other changes

  • Release signing: Scripts/sign-release.sh now signs with Scripts/fxcodex.entitlements (com.apple.security.automation.apple-events). Without it, the hardened runtime rejects Apple Events from release builds with errAEEventNotPermitted and shows no prompt. Local make builds aren't affected.
  • Dependencies: custom-dump stays on 1.6 so the package graph resolves.
  • README: new "Delivering links to a workspace" section, including the Arx Air Traffic Control setup.

Notes

  • Rebased onto the swift-subprocess change on main.
  • AppCommand.version is still 0.3.0. Bump it when cutting the release that ships this.
  • The fxCodex Raycast extension's new "Open Link in Workspace" command depends on this release. It reports a clear error with older executables.

Testing

  • make test: 167 tests pass (70 + 97).

🤖 Generated with Claude Code

… (DEV-860)

fxcodex open-url <workspace> <url> sends a codex:// link to that workspace's
Codex only: a kAEGetURL Apple Event addressed to the recorded process ID when
it runs, or a new instance launched with the workspace's environment and the
link when it doesn't. Never routes by scheme through Launch Services. Extracts
launchConfiguration(for:) so both launch paths share it, as in fxclaude.

Release builds are signed with com.apple.security.automation.apple-events,
because the hardened runtime rejects Apple Events (errAEEventNotPermitted, no
prompt) without it.

custom-dump stays on 1.6: 1.7 depends on swift-issue-reporting, whose
IssueReporting targets clash with xctest-dynamic-overlay used by
Dependencies 1.14.
@maximkrouk
maximkrouk merged commit 2273f40 into main Nov 14, 2026
2 checks passed
@maximkrouk
maximkrouk deleted the feat/open-url branch November 14, 2026 02:48
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