PeekaTest

A lightweight, unobtrusive on-screen bridge to Codex CLI.
Read visible test questions, ask your selected model, and see a concise suggested answer without switching apps.

Quick start · What it does · Modes & models · Configuration

Note

PeekaTest is a discreet overlay, not a guarantee of invisibility. Use it only where assistance is permitted; it does not evade third-party capture or proctoring.

What it does

PeekaTest helps find answers to test questions already visible on your screen:

1. Trigger — Start a run with a global shortcut, or let Auto mode run every 3–15 seconds.
2. Capture — Capture the visible test question from the screen.
3. Recognize — Read the question and visible choices with image understanding and local Apple Vision OCR where needed.
4. Select — Ask the exact chosen Codex model, at medium reasoning, for the best visible answer.
5. Present — Show the recognized question and concise selection, such as B — 4, without switching apps.

Auto mode can repeat this answer flow hands-free after the previous run finishes. PeekaTest suggests an answer; it does not click, fill, or submit controls in other apps.

Product tour

The answer stays in view

The compact overlay supports a two-column Question + Answer view and a full-width Answer only view. It can stay above normal windows and across Spaces while remaining click-through outside the brand drag area and the Settings/Quit controls.

Configuration without credential handling

Everything important is explicit

• Codex discovery, version, authentication, and exact-model diagnostics
• Luna, Sol, and Spark model selection with no silent fallback
• Manual shortcut or non-overlapping Auto capture
• 3–15 second Auto interval
• Question + Answer or Answer-only layout
• 25–100% main-overlay opacity

PeekaTest has no API-key field and never copies ChatGPT or Codex credentials into its settings.

Modes and models

Manual and Auto

• Manual — Press the configured global shortcut for an on-demand question or to cancel an active run.
• Auto — Repeat the answer flow every 3–15 seconds. Runs stay single-flight, skip busy ticks, and pause safely on error.

Manual and Auto are mutually exclusive.

Supported Codex profiles

Profile	Input path	Notes
Default — gpt-5.6-luna · medium	Screenshot + optional local OCR context	Default visual route.
gpt-5.6-sol · medium	Screenshot + optional local OCR context	Alternative visual route.
gpt-5.3-codex-spark · medium	Local Vision OCR text only	Fails clearly if the capture cannot be read locally.

PeekaTest uses the chosen profile exactly and reports an error instead of silently switching models.

Quick start

Requirements

• Apple Silicon (arm64) Mac
• macOS 14 Sonoma or newer
• Codex CLI authenticated through ChatGPT
• Screen Recording permission for PeekaTest

Intel Macs and Windows/Linux are not supported.

Run from source

npm ci
npm start

During source development, macOS grants Screen Recording permission to Electron rather than to the packaged PeekaTest bundle.

Install an internal unsigned build

This repository currently publishes source only; no DMG is stored in Git or attached as a GitHub Release.

If you receive an independently reviewed internal DMG through an authorized channel:

1. Verify its separately supplied SHA-256 checksum.
2. Open the DMG and drag PeekaTest.app to Applications.
3. In Finder, Control-click PeekaTest and choose Open. If needed, use System Settings → Privacy & Security → Open Anyway only after verifying the source and checksum.
4. Allow PeekaTest in System Settings → Privacy & Security → Screen & System Audio Recording, then quit and reopen it.

The current build is unsigned and not notarized. Do not treat it as publisher-verified.

Configuration

Connect Codex

1. Install Codex CLI, or an application bundle that includes it.
2. Run codex login in Terminal and finish ChatGPT sign-in.
3. Open PeekaTest Settings and choose Auto-detect / Refresh.
4. If discovery cannot find Codex, choose the executable explicitly or configure CODEX_PATH.
5. Select a model and run Test connection + model.

Discovery checks a saved executable override, CODEX_PATH, PATH, common package-manager locations, and bundled Codex locations in installed Codex/ChatGPT apps. A wrong or missing saved override fails clearly.

Authentication remains owned by Codex CLI/ChatGPT; PeekaTest does not ask for an API key.

Contributing, security, and license

See CONTRIBUTING.md, SECURITY.md, and CODE_OF_CONDUCT.md. PeekaTest is licensed under the MIT License. Electron/Chromium and development-tool notices are listed in THIRD_PARTY_NOTICES.md.