Peekaboo/docs/platform-support.md

summary	read_when
Reference matrix for Peekaboo macOS, Swift, Xcode, and Node requirements.	checking whether a macOS version or toolchain can run Peekaboo updating install, build, release, or package compatibility docs

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.