v3.2.0

[3.2.0] - 2026-05-15

Added

• peekaboo click --focus-background and the MCP click tool now support process-targeted background mouse delivery for apps identified by --app, --pid, or snapshot metadata.
• peekaboo agent now supports MiniMax M2.7 through Tachikoma's Anthropic-compatible provider path. Thanks @xiaofeiwa for #130.
• peekaboo agent now accepts ollama/<model> and lmstudio/<model> local model selections, including local-only provider defaults. Thanks @0x5845 for #137.

Fixed

• Ollama vision model IDs such as qwen2.5vl:3b now stay intact through Tachikoma model parsing instead of falling back to llama3.3 (#16).
• peekaboo agent now initializes with Gemini-only or MiniMax-only credentials instead of falling back to an unavailable OpenAI/Anthropic default. Thanks @lonexreb for #133.
• Window captures now retry transient SCScreenshotManager failures before reporting a minimized/off-screen/Space hint. Thanks @lonexreb for #135.
• The macOS app now keeps one status item/controller across app state reconnects and removes the status item on teardown, avoiding duplicate or ghost menu bar icons. Thanks @lonexreb for #134.
• Release automation now verifies CLI, npm, macOS app, checksum, appcast, and uploaded GitHub assets before publish.
• peekaboo type --json now separates requested text from executed key actions, making escaped special keys such as \n visible to agents without losing backwards-compatible typedText.
• peekaboo permissions status --all-sources now compares Bridge and local TCC permission state side by side, so daemon grants are no longer confused with CLI grants.
• peekaboo mcp serve --transport ... now rejects invalid transport names instead of silently starting stdio mode.
• peekaboo paste --app ... now fails before mutating the clipboard when the requested app cannot be found.
• peekaboo agent no longer sends stale Anthropic extended-thinking options to Claude Opus 4.7 and now exits with failure when agent execution fails.
• Command timeout JSON now reports the intended timeout error instead of occasionally surfacing cancellation as an unknown error.
• Refreshed CLI docs and quickstart examples to use current flags such as image --path, click --coords, type --return, press --count, and scroll --amount.

Performance

• Debug CLI startup no longer spawns git config on every launch when build-staleness checking is disabled, cutting startup-heavy command latency by more than 30% in local testing.

Release Verification

• npm: https://www.npmjs.com/package/@steipete/peekaboo/v/3.2.0
• npm tarball: https://registry.npmjs.org/@steipete/peekaboo/-/peekaboo-3.2.0.tgz
• npm integrity: sha512-Lwpruo1iYEeTFAsyybmTGEOFbuH5qqpDc3j1bQfz8XOLgBERbPpnLooY931rjg/ysmc7ALyP/Jx9zYKALiECzw==
• npm published: 2026-05-15T04:43:18.471Z
• GitHub tag: v3.2.0 at b0d17c2
• Notarization: accepted submission 842aa9b3-28ce-4288-bc4f-1dd60c1d28bf; app zip verifies as Notarized Developer ID.
• Preflight: pnpm run prepare-release passed SwiftFormat, SwiftLint, compiler warning scan, and pnpm run test:safe with 438 tests.
• CLI artifact: Peekaboo 3.2.0 (main/b0d17c23) verified from peekaboo-macos-universal.tar.gz.

Checksums

255ded65abdedfc61d0c2e9decfa0eb206c26ca916d1519f16d8f83dcc1af444  peekaboo-macos-universal.tar.gz
4696d2c392ea2fbb062f7b4e0eebe8c70796d5fecf4a4685329848bacfc364bd  steipete-peekaboo-3.2.0.tgz
e0048492bc90890cc11ad6e4c51f9b0b2cb23ede258456ef7c55c8c6819c32fb  Peekaboo-3.2.0.app.zip