Skip to main content

Module app

Module app 

Source
Expand description

macOS app integration command implementations.

Responsibilities:

  • Implement ralph app open by launching the installed SwiftUI app via the macOS open command.
  • Pass workspace context via custom URL scheme ralph://open?workspace=<path>
  • Keep the invocation logic testable by separating “plan” from execution.

Not handled here:

  • Building or installing the SwiftUI app (see apps/RalphMac/).
  • Any in-app IPC; the app drives Ralph by executing the CLI as a subprocess.

Invariants/assumptions:

  • The default bundle identifier is com.mitchfultz.ralph.
  • Non-macOS platforms reject ralph app open with a clear error and non-zero exit.
  • URL scheme ralph:// must be registered in the app’s Info.plist.

Functions§

open
Open the Ralph macOS app.