macOS companion
One small app
between Codex and your glasses.
Native Apple Silicon build for macOS 13 or newer. This v0.1 development release is unsigned.
Download v0.1.0 for Apple Silicon ↓- Build date
- 15 July 2026
- Architecture
- arm64
- Signing
- Unsigned
- SHA-256
- Generated with release
Install
- Open the downloaded DMG and drag Codex Glance to Applications.
- Because this development build is unsigned, Control-click the app, choose Open, then confirm. If macOS still blocks it, use System Settings → Privacy & Security → Open Anyway.
- Make sure Codex is installed and signed in, then open Codex Glance.
- Open the glasses app, enter its six-digit PIN in the companion, and wait for “Paired”.
Sharing & privacy
Defaults share titles, safe project nicknames, status, elapsed time, final summary, Git counts, and check state. Transcript defaults to Messages only. Turn transcript sharing off if prompts may contain sensitive text.
The companion redacts obvious keys, bearer tokens, private keys, password assignments, and connection strings. Redaction is defense in depth, not a guarantee—review your setting before sharing transcripts.
Troubleshoot
Codex is not detected
Install or update Codex, run codex --version, and sign in through the official Codex app or CLI. The companion never handles your credentials.
The App Server will not connect
Run codex app-server --help. Codex Glance first tries the managed daemon proxy and then a dedicated local stdio App Server.
The glasses show stale data
Keep the companion running, check internet access, and open Debug on both devices. The last known state remains visible while reconnecting.
Stop is unavailable
The control is enabled only when the installed App Server exposes turn/interrupt and the active turn is addressable. It never simulates success.
Uninstall & delete data
Use Unpair and delete relay data in the companion first. Then quit Codex Glance, remove it from Applications, and disable its login item in System Settings if enabled. “Delete local data” removes preferences; pairing credentials are deleted from Keychain.
Release notes
v0.1.0 — initial experimental release with official App Server detection, live relay, recent threads, usage, optional transcript, Git summary, Stop capability detection, Keychain pairing, reconnect, and debug reporting.