Skip to content

ScreenCue 0.2.0 - Native AI client integrations

Pre-release
Pre-release

Choose a tag to compare

@CrioNIK CrioNIK released this 17 Oct 00:07

Native client integration packages for Codex, Claude Code, Claude Desktop, Gemini CLI, and Cursor, with English documentation, runtime labels, examples, and previews.

  • Codex: portable plugin, compatibility manifest, local marketplace, MCP configuration, and skill.
  • Claude Code: native plugin, MCP configuration, and skill.
  • Claude Desktop: native .mcpb extension and a separate uploadable skill ZIP, for Windows/macOS.
  • Gemini CLI: extension, MCP configuration, skill, context, and show/hide/status commands.
  • Cursor: local plugin, MCP configuration, skill, and scoped rule.
  • Optional Python installer with safe configuration merges, backups, dry run, and a connection doctor. Packaged plugins run the native binary directly, without Python or Node.js.
  • Agent guidance prioritizes passive observation and immediate pointing, without opening another window or relaying the request to another chat. Hiding a cue calls screen_clear directly.

Download: choose screencue-integrations-PLATFORM.zip for ready-made client packages, or the smaller screencue-PLATFORM archive for the standalone binary. Extract into a permanent folder and follow the included README or client guides. Use one connection per client to avoid duplicate overlays.

Validation: 44 Rust unit tests, 15 installer/package tests, MCP protocol checks, and the Windows native overlay suite passed. All four CI builds passed. The downloaded release archives were checked for matching platform binaries, executable permissions, licenses, resolved plugin paths, and English text. Actual Codex plugin loading/tool calls, Claude Code plugin MCP connection, and Gemini CLI MCP connection were tested. Claude Desktop MCPB and Cursor plugin format validation passed. See the detailed verification record for exact versions and evidence.

Known Gemini CLI issue: with Gemini CLI 0.61.0 and Node.js 24.12.0 on the tested Windows machine, extensions link registered the extension but then failed during CLI shutdown. A separate unattended extensions install attempt timed out. Skill discovery and MCP connection still passed. The repository's standalone scripts/integrate.py configure --client gemini route avoids extension installation and its configured MCP connection passed the doctor check. This is a client lifecycle issue, not a claim that every installation path is clean.

These packages do not supply screen vision or guarantee authenticated visual interaction in every AI client. Direct Dot voice access remains unverified. macOS and Linux graphical desktop behavior still requires native manual testing; Linux requires X11 with a compositor, and native Wayland is unsupported. Binaries and MCPB packages are unsigned.

Hide a hint with Ctrl+Alt+X (Ctrl+Option+X on macOS). Existing click-through drawing, adaptive red, animated sketch arrow, independent target outlines, and local window tracking remain available.

Checksums are in SHA256SUMS.txt. Code is MIT licensed; embedded IBM Plex Mono is SIL OFL 1.1. Third-party license notices are included.