AIRS is a macOS application for reviewing what a compiled program contains without running it. You select an application, a framework or a single ARM64 Mach-O file, and AIRS reads it as data and shows what it found, what it could not decide, and why.
It has two parts:
- a native macOS application (SwiftUI and AppKit) for selecting inputs, reviewing results and saving them, and
- an analysis engine written in Python with no dependency outside the standard library, which also runs on its own from the command line.
- Unwind audit. For each function in an ARM64 image, AIRS compares the recorded unwind information with what a bounded reading of the instructions supports. Each function gets a verdict and, when the verdict is not agreement, a reason.
- Component review. AIRS lists the code units inside an application bundle with their signatures and entitlements. For a previous and a current version of the same application it reports what changed in the declared permissions and components (Security Changes).
- Swift error flow. For selected images, AIRS finds calls to throwing Swift functions and the paths their success and error returns take, within stated limits (Swift error flow).
- Saved reports. Results are saved as files that can be reopened, summarised and compared across builds (examples).
- It never loads or executes the program it is inspecting. A selected binary is input data.
- It watches nothing and fetches nothing. A person selects each input.
- It does not count an undecided result as agreement. Functions and changes it could not decide stay in every total, each with a reason.
A result describes the structure of the bytes that were read. It is not a statement that a program is safe, trusted or correct, that a code path runs, or what the original source looked like. Signature and entitlement evidence is a record of what the file declares; it does not authenticate the signer. Every analysis has a named model with documented limits, and anything outside those limits is reported as unsupported or unresolved. The limits are listed in the analysis contract and the page for each model.
Download the current release from the releases page. Each release provides the signed and notarized application archive, the exact source, a qualification summary and SHA-256 checksums.
The current release is the AIRS 0.4.0 build 33 preview. It requires macOS 27 on Apple silicon and adds the imported-callee Swift error-flow profile (release record).
- AIRS 0.4.0 and later: macOS 27 or later on Apple silicon.
- AIRS 0.3.4 build 32 is the last release for macOS 14 to 26. It declares macOS 14 as its minimum and was never tested on it.
- Intel Macs are not supported.
The application includes its own Python runtime. Nothing else needs to be installed.
Building requires macOS 27, Xcode 27 or later, and Python 3.11 or later.
swift build --package-path native --configuration release --product AIRSApp
swift build --package-path native --configuration release --product airs-entitlements
python3 -I -B airs_cli.py --version
A developer bundle that uses the system Python is assembled with
bash scripts/package-app.sh --release --external-python. A standalone bundle needs a
prepared private Python runtime (PRIVATE_PYTHON.md).
The product has one version. The literal __version__ in src/airs/__init__.py
defines it; the package metadata and a Swift constant are copies that a test checks.
Continuous integration runs the Python tests on two Python versions, builds and tests the native package on a hosted macOS 27 runner, checks the ARM64 decoders against an independent disassembler, and scans every pull request for text that must not be published. CONTRIBUTING.md describes the workflow.
- Roadmap: what is planned, what is not, and why.
- Architecture and the analysis contract.
- Model registry: every analysis model and what it admits.
- Release acceptance: how a published archive is checked on a clean machine, and what that check does not cover.
- Release documents: 0.4.0 build 33, 0.3.4 build 32, 0.3.4 build 29, 0.3.3 build 12, 0.3.3 build 10, 0.3.3 build 9 and the release history.
- Known macOS limitation in window-geometry diagnostics.
This is the only active AIRS repository. The source excludes private history,
maintainer records, logs, screenshots, corpus locations and compiled applications.
Owned regression fixtures and public schemas are included. SOURCE_FILES.txt,
SOURCE_EXPORT_SCOPE.json and SOURCE_SNAPSHOT.json describe the original 0.3.3
source import and are kept as records of it.
AIRS and Lumen are licensed under the MIT License. AIRS uses the
public Lumen 1.3.0 release pinned in native/Package.resolved; the older
vendored snapshot remains for historical provenance and is not linked.
EntitlementDiff keeps its MIT license, and Python's licenses accompany the
packaged runtime. See third-party notices.