Brownfield projects
Use the minimal integration profile when the project already builds and you want evidence without adopting Axint's generation, memory, or project setup.
axint run \ --integration=minimal \ --local-only \ --advisory \ --no-fix \ --dir /path/to/MyApp \ --scheme MyApp \ --changed Sources/Feature.swift--integration=minimal enforces the other safety properties even when their
explicit flags are omitted.
The contract
Section titled “The contract”Minimal mode guarantees:
- no source generation
- no project instructions, memory, session, or MCP installation
- no hosted or network checks
- no automatic fixes
- no
.axintdirectory written into the project - no durable artifacts unless
--output-diris supplied - no unconfirmed static finding blocks the run
Xcode still writes DerivedData to the operating system's temporary directory
unless you pass --derived-data. That is build output, not project integration.
Keep a receipt outside the project
Section titled “Keep a receipt outside the project”axint run \ --integration=minimal \ --dir /path/to/MyApp \ --scheme MyApp \ --output-dir /path/to/proof-receipts/my-appThe selected directory receives latest.json, latest.md, command logs, and
the test result bundle when tests run. Without --output-dir, minimal mode
returns the report to stdout and leaves no durable Axint artifact.
Static findings in minimal mode
Section titled “Static findings in minimal mode”Minimal mode preserves every finding but sets unconfirmed findings to non-blocking. A finding can become confirmed when Xcode emits a matching error. A compiler-shaped finding can become suppressed when the selected build passes. Accessibility, interaction, privacy, design, and runtime advisories remain visible because compiler success does not evaluate them.
Use the evidence model for the exact states.
Full integration later
Section titled “Full integration later”Move to the default axint run profile only when the project benefits from
durable sessions, project context, feedback signals, and the full agent
workflow. Minimal mode does not silently graduate the project into that setup.