macOS App

macOS App

The Jarvis Line manager is a native SwiftUI companion for the Python CLI and runtime. It is currently Preview: useful for daily local management, but the public DMG is not yet Apple-notarized.

The current tagged app is v0.8.3 (build 14).

The CLI remains the core engine. Installing the app does not make Jarvis Line Codex-only; Claude, Gemini, and custom adapters can use the same runtime.

What The App Provides

• menu bar health and queue status
• start, stop, restart, repair, and voice-test controls
• guided Setup Assistant backed by the CLI's versioned config contract
• constrained runtime and TTS settings
• immediate Attention alerts on/off switch in the quick panel
• optional final completion chime and independent volume controls in full Settings
• diagnostics and privacy-safe trace summaries
• update checks
• optional Dock visibility

The menu bar panel keeps frequent controls close. Full configuration and diagnostics open in the main Settings window.

Attention Alerts Switch

The quick panel includes Attention alerts with the description Speak permission and Plan requests.

• switch off: writes only attention_enabled = false
• switch on: writes only attention_enabled = true
• no runtime restart is required
• unrelated unsaved full-Settings changes are not written
• the control is unavailable when all speech or speak mode is off

The same preference appears under Settings → Speech → Events and Setup Assistant.

Final Completion Chime

Use Settings → Speech → Events → Final chime to control the short cue that plays immediately before final speech. It is enabled by default in v0.8.3. Use Final chime volume to set the cue from 0% to 100% in 5% steps without changing speech volume. The controls are unavailable when speech or speak mode is off. They do not choose an audio file or add another persistent worker; the runtime generates and serializes the cue through the existing audio worker.

Install From A DMG

1. Download the DMG and checksum from a tagged GitHub release.
2. Verify the checksum listed with that release.
3. Open the DMG.
4. Drag Jarvis Line.app to Applications.
5. Replace the existing app when Finder asks during an update.
6. Launch the app from Applications.

Jarvis Line uses one bundle identifier and blocks duplicate running instances. A new DMG should replace the existing installation rather than creating a second independently running manager.

Signing Status

Current Preview artifacts are ad-hoc signed for bundle integrity but are not notarized by Apple because the project does not yet publish with a Developer ID. macOS may therefore show an unidentified-developer warning.

Verify that the file came from the official release and that its checksum matches. Use Finder's normal Open flow if you trust the verified artifact. Do not disable Gatekeeper globally.

Setup Assistant

The assistant inspects the real CLI environment and asks for:

• language
• available TTS backend
• speech mode
• agent target
• instruction scope
• optional attention alerts
• optional Codex hook installation
• runtime start and voice test

It shows a review before applying changes and prints instruction guidance for manual paste. It does not silently edit AGENTS.md, CLAUDE.md, or GEMINI.md.

Build From Source

cd apps/macos/JarvisLine
swift test
./scripts/package-app.sh
./scripts/package-dmg.sh

Exact development, packaging, and current MVP notes live in the versioned macOS app README.

Known Preview Limits

• no Apple notarization yet
• app behavior is primarily exercised on Apple silicon
• system voice inventory depends on installed macOS voices
• the Python CLI/runtime must remain installed and discoverable
• Windows and Linux do not have a matching native manager app

Please include the app version, CLI version, macOS version, and a reviewed support report when opening an app-specific issue.