Glance

Experimental pre-release software. Complete the public-release checklist before relying on it for sensitive work.

Glance puts live Codex activity on Meta Ray-Ban Display. It complements Codex’s full desktop and mobile interfaces by keeping status, recent messages, attention notices, threads, and usage glanceable in your field of view. A native macOS menu-bar companion reads the official local Codex App Server, normalizes a small display model, and publishes it through a paired Cloudflare Durable Object.

• Website: https://glance.familybusiness.studio/
• Glasses app: https://glance.familybusiness.studio/app/
• macOS download: https://glance.familybusiness.studio/download/
• Source: https://github.com/coob113/Glance
• Relay health: https://codex-glance-relay.coob1113.workers.dev/health

Requirements

• Apple Silicon Mac running macOS 13 or newer
• Official Codex app or CLI installed and authenticated
• Internet access
• Meta Ray-Ban Display web-app access (desktop mouse, touch, and keyboard are supported for debugging)

The v0.1.3 DMG is ad-hoc signed, not Developer ID signed or notarized. Intel is not built. Codex 0.144.2 is the verified protocol version; optional capabilities are feature-detected.

Install and pair

1. Download Glance-0.1.3-arm64.dmg from the download page.
2. Drag Glance to Applications. Control-click it and choose Open for this development build.
3. Open the glasses app. It creates a six-digit PIN that expires in five minutes.
4. Enter that PIN in the Mac companion. Returning devices reconnect using separate revocable credentials.
5. Choose a transcript level and other sharing controls in the companion.

Credentials stay in Codex. The publisher credential is stored in macOS Keychain; the viewer credential is stored in browser storage. The relay never receives Codex credentials, source files, environment variables, authentication files, arbitrary terminal output, or hidden reasoning.

Repository

apps/web            Landing, download, and 600×600 MRBD app
apps/worker         Cloudflare Worker and SQLite Durable Objects
apps/companion      Native SwiftUI/AppKit menu-bar companion
packages/protocol   Versioned Zod schemas and privacy helpers
packages/codex-adapter  Typed adapter and installed Codex protocol snapshot
docs                Architecture, privacy, deployment, and support notes

The root static files are a generated mirror of apps/web/dist for the existing zero-build-command Pages Git integration. Edit apps/web, never the mirror, then run pnpm sync:pages-root.

Develop

corepack enable
pnpm install
pnpm dev:worker

In a second terminal:

pnpm dev:web

For the native companion:

CODEX_GLANCE_RELAY_URL=http://localhost:8787 pnpm --filter @codex-glance/companion dev

Simulation emits believable normalized snapshots only when explicitly enabled outside production:

CODEX_GLANCE_SIMULATION=1 pnpm simulate

The glasses UI also supports http://localhost:5173/app/?simulation=1; this path is refused on non-local hosts.

Test and build

pnpm test
pnpm typecheck
pnpm audit --prod
pnpm build
pnpm release:mac
pnpm sync:pages-root
node scripts/verify-production.mjs

pnpm test runs protocol, Worker, web, Codex-adapter, and native companion self-tests. pnpm --filter @codex-glance/companion test:xcode runs the retained XCTest target on a full Xcode installation.

Deploy

pnpm deploy:worker
pnpm deploy:web

Deploy staging first when changing relay state:

pnpm --filter @codex-glance/worker run deploy:staging

See architecture, security and privacy, Codex adapter notes, Cloudflare deployment, macOS release, maintenance and public-release readiness, and troubleshooting.

Contributing and license

Contributions are welcome under the guidance in CONTRIBUTING.md. Security reports should follow SECURITY.md. Glance is available under the MIT License; bundled third-party notices are listed in THIRD_PARTY_NOTICES.md.