Release Notes — Periphery

DownloadSeptember 3, 2026

DownloadAugust 19, 2026

Removed the xcode_list_arguments configuration option, as xcodebuild -list is no longer invoked.
Removed the skip_schemes_validation configuration option. Scheme names are no longer validated, so any scheme can be given, including that of a Swift package.

Discover Xcode schemes by parsing the project instead of running xcodebuild -list, which is significantly faster.

Fix indexing implicitly discovered Interface Builder and Core Data resources in Swift packages.
Fix unstable DerivedData path generation.
Fix --retain-public, retain_public: true, and // periphery:ignore not retaining public macro declarations.
Fix false positive redundant public accessibility warnings for result builders used by public function and initializer parameters.
Fix a scan crash when a filesystem-synchronized Xcode source folder starts with **.
Fix hand-quoted build_arguments values, such as OTHER_SWIFT_FLAGS='$(inherited) -no-warnings-as-errors', being re-quoted when they follow a boolean flag.

DownloadAugust 12, 2026

DownloadJuly 30, 2026

Added the agent-prompt output format for AI-assisted result removal.
Added the name option to the // periphery:override comment command.
Scheme validation is now skipped by default, avoiding a slow call to xcodebuild. Use --no-skip-schemes-validation to enable validation of the given scheme names.

The --write-results file is now written when the output format produces no output for a scan with no results, e.g. --format github-actions.
Resolved scan performance regression introduced by duplicate declaration detection.

DownloadJuly 21, 2026

Conflicting declarations now throw an error.
Bazel integration has moved to the rules_periphery module, which drives Periphery from Bazel rather than the other way around. The --bazel, --bazel-filter, --bazel-query, --bazel-index-store, and --bazel-check-visibility options have been removed.

Significant performance improvements.
Added the --retain-equatable-properties and --retain-hashable-properties options to retain all properties on Equatable and Hashable types.

Release notes for versions prior to the fork from the open-source project are available in the previous changelog.