Releases: legetdev/klyk
Release list
v0.5.2
Reliability and maintenance update.
- Prevent shell-client pipe stalls, partial-response hangs, and failed-start process leaks.
- Release mouse buttons when clicks are cancelled, and fail scoped screenshots without capturing the whole desktop.
- Reject invalid template search regions and improve save-result verification.
- Preserve configuration files atomically, recover malformed cached state, and redact quoted JSON credentials.
- Correct stale documentation, permission guidance, and window-position bookkeeping.
Validation: 90 portable regressions passed across supported MCP generations; the four-job CI matrix, package metadata/privacy checks, and installed-package MCP discovery passed. Additional native click/capture/save acceptance is deferred to follow-up testing.
v0.5.1
Antigravity setup now uses its documented global MCP configuration, so new agy sessions can load klyk natively without shell discovery workarounds.
- Detect and repair legacy Antigravity installations while preserving legacy files, other servers, custom klyk settings, and file permissions.
- Clarify that installation and doctor verify configuration rather than an existing client connection, and document workspace configuration and native MCP verification.
- Require a window label or ID in the focus_window schema, retaining both existing targeting forms and exposing the requirement in shell discovery.
- Correct shell session and takeover guidance; preserve single-driver protection and all other client adapters.
v0.5.0
This release improves the reliability of existing Mac control tools and makes failed or uncertain actions easier for agents to handle.
- Reject ambiguous AX targets, invalid window bounds, failed activation, and unsafe background fallbacks before input. Preserve explicit window targets through batches and field filling, and avoid closing sibling documents when a selected window disappears.
- Stop failed batches, release held input on interruption, restore clipboard contents before paste returns, preserve Unicode, and prevent modifier leakage into later typing. Verify Open dialog paths before submitting them.
- Correct Chromium semantic-click delivery, avoid launching a second default-profile app when attaching, fail closed when ownership cannot be verified, preserve unchanged OpenCode configuration, and improve credential scrubbing.
- Clarify observation, action, and verification guidance while retaining all 48 tools and existing parameters. The loaded tool schema is about 9% smaller; this is not a claim about model accuracy or task speed.
- Add 55 portable regression tests, real AppKit/browser/Electron fixtures, both MCP major-version CI checks, and release gates that reject stale Mac evidence and private/generated package content.
Validation: all 48 tools exercised through real MCP on macOS 26.5.2 with MCP 1.28.0 and 2.1.1; independent native app state, Chrome page events, Electron file contents, cross-app drops, background cursor/focus preservation, and clean-wheel discovery/input-free calls checked. Hardware coverage was one display. Physical emergency-shortcut acceptance remains a separate manual check. Input delivery metadata does not establish task completion; observe the outcome after actions.
Update an existing installation with klyk update. Shared-install clients load the update when their servers restart; separately pinned or bundled installations need their own update.
v0.4.1
v0.4.0
v0.3.0
Staying up to date is now effortless. klyk update detects how klyk was installed (pipx, uv, or pip) and runs the matching upgrade — fixing a silent failure on pipx/uv installs — then automatically restarts the running server so every connected AI client loads the new version on its next call. klyk doctor now reports whether you're on the latest release, the menu-bar eye shows an update notice when a newer version exists, and klyk update --check reports freshness without changing anything. The check is a once-daily, offline-safe read of klyk's own PyPI metadata (nothing about you is sent; disable with KLYK_UPDATE_CHECK=0). Install: pipx install klyk · Update: klyk update
v0.2.0
Native clicks and drags are now fully invisible — SkyLight key-window routing drives backgrounded native apps with no focus theft and no window raise (via: skylight+keyed). Command-shortcut/paste paths activate only when macOS requires it; no silent failures.
v0.1.2 — Scroll focus-theft fix
Bug-fix release. No API or tool-behavior changes.
Fixed
- Autonomous-mode
scrollunnecessarily activated (foregrounded) native apps before every call, even though scroll delivers its full effect to a backgrounded app with zero activation — matching the same OS convention as scrolling under the pointer without clicking to focus first. Verified visually (a background scroll moved real window content) before and after the fix. - Click, double-click, triple-click, and drag were re-verified and confirmed to genuinely require activation on a non-key native window (this matches standard AppKit behavior, not a klyk limitation) — unchanged.
Install
pip install --upgrade klyk
v0.1.1 — Hang fixes
Bug-fix release. No API or tool-behavior changes.
Fixed
- Session creation, window listing, and app close could hang for minutes under load instead of failing fast within their documented timeout budgets.
- Root cause of the worst hangs (up to ~250s observed): closing an app's log stream stopped the reader thread before terminating the process still writing to it, which could block on an OS-level pipe lock. The process is now terminated first, so cleanup completes in milliseconds instead of stalling.
Install
pip install --upgrade klyk