Skip to content

Peekaboo 2.0.0

Choose a tag to compare

View all tags
@steipete steipete released this 03 Jul 21:05
· 2 commits to cli since this release
v2.0.0
d0676c4

This major release rewrites Peekaboo as a native Swift CLI with integrated AI vision capabilities.

Highlights

  • Native Swift CLI for better performance and macOS integration
  • Built-in AI analysis with OpenAI or Ollama
  • Configuration file support (JSONC with env expansion)
  • Homebrew distribution (brew install steipete/tap/peekaboo)
  • Model Context Protocol (MCP) server support
  • Comprehensive test suite (331 tests)

Installation

Homebrew (Recommended)

brew install steipete/tap/peekaboo

NPM (for MCP server)

npm install -g @steipete/peekaboo-mcp

New Features

Multiple Capture Modes

  • Window capture (single or all windows)
  • Screen capture (main or specific display)
  • Frontmost window capture
  • Multi-window capture from multiple apps
  • PID targeting with PID:12345 syntax

AI Vision Analysis

# Analyze with OpenAI
PEEKABOO_AI_PROVIDERS="openai/gpt-4o" peekaboo analyze image.png "What is shown?"

# Analyze with Ollama
PEEKABOO_AI_PROVIDERS="ollama/llava:latest" peekaboo analyze image.png "Describe this"

Configuration Management

peekaboo config init      # Create default config
peekaboo config show      # Display current config
peekaboo config edit      # Edit in default editor
peekaboo config validate  # Validate syntax

Permission Checking

peekaboo list permissions  # Check system permissions

Technical Improvements

  • Universal binary (Intel + Apple Silicon)
  • Code signed with Developer ID
  • Embedded Info.plist for proper permissions
  • Optimized binary size (~2.1 MB)
  • Enhanced error messages
  • Better permission visibility

Breaking Changes

  • Node.js CLI replaced with Swift implementation
  • Some command syntax changed (see README)

Thanks

Special thanks to everyone who contributed and tested!

See the CHANGELOG for full details.

Assets 4
Loading