Peekaboo MCP

# Changelog All notable changes to Peekaboo CLI will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ## [2.0.2] - 2025-07-03 ### Fixed - Actually fixed compatibility with macOS Sequoia 26 by ensuring LC_UUID load command is generated during linking - The v2.0.1 fix was incomplete - the binary was still missing LC_UUID despite the strip command change - Added `-Xlinker -random_uuid` to Package.swift to ensure UUID generation - Verified both x86_64 and arm64 architectures now contain proper LC_UUID load commands ## [2.0.1] - 2025-07-03 ### Fixed - Fixed compatibility with macOS Sequoia 26 (pre-release) by preserving LC_UUID load command during binary stripping - The strip command now uses the `-u` flag to ensure the LC_UUID load command is retained, which is required by the dynamic linker (dyld) on macOS 26 ### Technical Details - Modified build script to use `strip -Sxu` instead of `strip -Sx` to preserve the LC_UUID load command - This ensures the binary includes the necessary UUID for debugging, crash reporting, and symbol resolution on newer macOS versions ## [2.0.0] - 2025-07-03 ### Added - **Standalone Swift CLI** - Complete rewrite in Swift for better performance and native macOS integration - **MCP Server** - Model Context Protocol support for AI assistant integration - **Multiple Capture Modes**: - Window capture (single or all windows) - Screen capture (main or specific display) - Frontmost window capture - Multi-window capture from multiple apps - **AI Vision Analysis** - Analyze screenshots with OpenAI or Ollama directly from Swift CLI - **Configuration File Support** - JSONC format configuration at `~/.config/peekaboo/config.json` with: - Environment variable expansion (`${HOME}`, `${OPENAI_API_KEY}`) - Comments support for better documentation - Hierarchical settings for AI providers, defaults, and logging - **Config Command** - New `peekaboo config` subcommand to manage configuration: - `config init` - Create default configuration file - `config show` - Display current configuration - `config edit` - Open configuration in default editor - `config validate` - Validate configuration syntax - **Permissions Command** - New `peekaboo list permissions` to check system permissions - **PID Targeting** - Target applications by process ID with `PID:12345` syntax - **Homebrew Distribution** - Install via `brew install steipete/tap/peekaboo` for easy installation and updates - **Comprehensive Test Suite** - 331 tests with 100% pass rate covering all major components - **DocC Documentation** - Comprehensive API documentation for Swift codebase ### Changed - Complete architecture redesign separating CLI and MCP server - Improved performance with native Swift implementation - Better error handling and permission management - More intuitive command-line interface following Unix conventions - Enhanced permission visibility with clear indicators when permissions are missing - Unified AI provider interface for consistent API across OpenAI and Ollama - Logger's `setJsonOutputMode` and `clearDebugLogs` methods are now synchronous for better reliability ### Fixed - Configuration precedence (CLI args > env vars > config file > defaults) - SwiftLint violations across the codebase - ImageSaver crash when paths contain invalid characters - Logger race conditions in test environment - PermissionErrorDetector now handles all relevant error domains - Test isolation issues preventing interference between tests - Various edge cases in error handling and file operations ### Removed - Node.js CLI (replaced with Swift implementation) - Legacy screenshot methods ## [1.1.0] - 2024-12-20 ### Added - Initial TypeScript implementation - Basic screenshot capabilities - Simple MCP integration ### Changed - Various bug fixes and improvements ## [1.0.0] - 2024-12-19 ### Added - Initial release - Basic screenshot functionality