Platform support
This page collects the platform requirements surfaced by Peekaboo's package, project, CI, and install metadata so install, build, and release docs do not drift. It is descriptive, not an additional guarantee that every listed combination is continuously tested.
| Surface | Minimum | Notes |
|---|---|---|
| Released CLI and MCP package | macOS 15.0+ | The CLI package target is Apps/CLI/Package.swift, which declares .macOS(.v15). The npm package wraps the same CLI binary. |
| macOS app | macOS 15.0+ | The Xcode project Apps/Mac/Peekaboo.xcodeproj/project.pbxproj sets MACOSX_DEPLOYMENT_TARGET = 15.0. The app's SwiftPM package metadata still declares .macOS(.v14) for package resolution. |
| Core Swift packages | macOS 14.0+ package metadata | Root and core package manifests such as Package.swift and Core/PeekabooCore/Package.swift declare .macOS(.v14), but host features that capture screens, inspect windows, control Spaces, or drive Accessibility follow the CLI/app requirements. |
| CLI source builds | macOS 15.0+, Swift 6.2+ toolchain | The CLI manifest declares .macOS(.v15) and swift-tools-version: 6.2; maintainers and CI use Xcode 26.x or newer when available. Older Xcode fallback paths in .github/workflows/macos-ci.yml do not lower the SwiftPM toolchain requirement. |
| pnpm helper scripts | Node.js 22+ | package.json declares engines.node >=22.0.0. Node is required for docs/build/release helper scripts and for the npm MCP wrapper; core Swift builds do not require Node. |
If a doc mentions platform support, prefer linking back here instead of restating a separate compatibility matrix.