Repository navigation
ScreenCue 0.0.4 - Desktop app and independent model connections
Pre-releaseScreenCue now opens as a native desktop application with dark settings, a red sketch icon, and independent conversation notes.
Downloads
- Windows:
ScreenCue-0.0.4-windows-x64-setup.exe— per-user installer, Start menu entry, optional desktop shortcut, uninstall. - macOS: the Apple Silicon or Intel DMG — drag ScreenCue into Applications; macOS 14.2+ (system audio requires 14.6+).
- Linux: the X11 app archive — extract and run
sh install.shfor a user-menu installation. - Smaller renderer-only archives and Codex/Claude/Gemini/Cursor integration bundles remain available.
What's included
- Independent
screen_promptMCP tool: display speaking notes immediately without screen coordinates or a screenshot. - Settings for appearance, adaptive text-panel width, animation, capture privacy, and explicit conversation Start/Stop.
- Four independent connection profiles: Audio & speakers, Fast model, Big model, and System 1. Each supports its relevant API or command-bridge contract, model selection, and its own credential. Keys can use Windows Credential Manager, macOS Keychain, Linux Secret Service, or an environment reference; they are not saved in settings JSON.
- Windows native capture exclusion for the settings and overlay windows, with exact policy readback. Capture compatibility is application-dependent; macOS/Linux report unsupported.
- Optional native microphone/system-audio helper, OpenAI-compatible endpoints, generic command adapters, structured speaker IDs, and explicit role mapping.
- Optional independent fast LLM, slow planning, and typed-decision lanes. Jev and other configured decision adapters can act without waiting for either LLM. The planner prepares bounded response/question/topic-bridge candidates; fast text can stream while it works.
- Stale-answer rejection, bounded queues, safe action allowlists, stop cancellation, and coordinated hiding across active connections. Ctrl+Alt+X hides cues and stops listening.
No audio starts automatically. Models, accounts, API keys and model weights are not bundled. The native app/basic audio helper need no interpreter; the optional advanced orchestrator requires an existing Python 3.11+ executable configured by absolute path.
Verification and limits
Local verification includes 86 native app tests, 12 native helper tests, 85 passing Python tests, a synthetic Windows credential-store round-trip, live MCP hints, native privacy/style checks including minimize/restore, and UI Start/Stop/restart using a synthetic helper. Provider tests use fake HTTP/command/SSE responses; no live meeting audio or paid model service was used.
Release CI passed on all four platforms, including Windows native UI and installer install/uninstall, macOS bundle signing and DMG verification, and Linux user installation/removal. Downloaded assets were collected from this run for commit 61d98ab3f5ee0c32da13d5b4fcf18919e0c1ad96; SHA256SUMS.txt covers all twelve packages.
Stable speaker identity requires a suitable diarization adapter. Live diarization accuracy and speech-to-useful-cue latency are not benchmarked. Universal screen-share invisibility, native Wayland, and arbitrary exclusive-fullscreen game support are not claimed.
The Windows installer is unsigned. macOS uses ad-hoc integrity signing, not Developer ID notarization.
Setup · Connections and keys · Conversation architecture and providers · Verification