![\"Axint](\"docs/assets/mark-dark.svg\")
\n ![\"Axint\"](\"docs/assets/wordmark-dark.svg\")
\n \n \n \n
\n The proof and repair layer for Apple coding agents.\n
\n\n\n Axint checks the Swift your agent wrote, runs the real Xcode build and tests,
\n reconciles findings with Apple tooling, and returns signed proof with the exact repairs to make next.
\n No project rewrite. No source upload.\n
\n ![\"npm](\"https://img.shields.io/npm/v/@axint/compiler?color=f05138&label=npm\")
![\"monthly](\"https://img.shields.io/npm/dm/@axint/compiler?color=2f3431&label=downloads\")
![\"PyPI](\"https://img.shields.io/pypi/v/axint?color=3775a9&label=PyPI\")
![\"continuous](\"https://github.com/agenticempire/axint/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n ![\"Apache](\"https://img.shields.io/badge/license-Apache%202.0-2f3431\"){kind=icon}
\n Prove a project ·\n Try Cloud Preview ·\n Connect an agent ·\n Docs ·\n Examples ·\n Contribute\n
\n\n\n ![\"Axint](\"media/intro.gif\")
\n
Local by default. Open source. Ordinary Swift.
\n\n## A plausible patch is not proof.\n\nApple software is a graph of contracts. SwiftUI state, App Intents, Siri and\nShortcuts metadata, widgets, entitlements, privacy declarations, concurrency,\nbuild settings, tests, and runtime behavior all have to agree. Code that looks\nright can still fail to compile, miss an interaction, or violate a platform\ncontract.\n\nAxint puts static analysis and Apple tooling into one repair loop. Static checks\nidentify leads; Xcode build and test output can confirm, contextualize, or\nsuppress them. The result stays compact enough for the next agent turn while\nfull logs and artifacts remain on disk.\n\n| Evidence class | What it means |\n| -------------- | --------------------------------------------------------------------------------------------------------------------------- |\n| **Confirmed** | Deterministic analysis or matching compiler, build, or test evidence supports the finding. |\n| **Probable** | Strong static evidence identifies a likely problem, but decisive Apple-tooling evidence is incomplete. |\n| **Advisory** | A heuristic identifies a quality, accessibility, privacy, interaction, design, or runtime concern for review. |\n| **Suppressed** | Stronger evidence or a project-local review contradicts the finding; it remains in the receipt without blocking the result. |\n\n## Prove an existing project\n\n```bash\nnpx -y -p @axint/compiler axint prove --dir /path/to/MyApp\n```\n\nAxint discovers the Xcode project and scheme, checks existing Swift, runs the\navailable build and tests, reconciles the findings, and writes proof under\n`.axint/proof`.\n\nThe default local run requires no account or configuration. It does not change\nSwift, upload source, install project instructions, install memory or MCP\nconfiguration, apply fixes, or rewrite the project.\n\nWhen a failure needs another turn, Axint returns a\n[**Fix Packet**](docs/FIX_PACKET.md): a compact repair artifact with the finding,\nlikely files, exact next action, and rerun command. It also writes a\n**source-free receipt**: a signed proof file containing evidence, results,\nhashes, and repair information without project source.\n\n```bash\naxint prove --dir /path/to/MyApp --fix\naxint receipt verify /path/to/MyApp/.axint/proof/latest.proof.json\n```\n\n`--fix` opts into supported deterministic rewrites and reruns the proof loop.\nReceipt verification checks payload integrity and the embedded Ed25519 signer.\nA locally signed receipt does not establish an externally trusted identity\nunless CI or the receiving team pins the signer fingerprint or a managed\nsigning key.\n\n## One proof contract\n\nGenerate, Check, Run, Team, and Cloud are different entry points into the same\ncontract: verdict, evidence, findings, next actions, and artifact paths.\n\n| Mode | Role in the proof loop |\n| ------------ | --------------------------------------------------------------------------------------------------------------------------------- |\n| **Check** | Validate generated or existing Swift with evidence-aware diagnostics and appropriate abstention. |\n| **Run** | Orchestrate resumable build, test, runtime, and `.xcresult` evidence on a local or your own Mac runner. |\n| **Generate** | Compile smaller contracts into inspectable App Intents, SwiftUI views, widgets, Live Activities, app shells, metadata, and tests. |\n| **Team** | Preserve project context, sessions, file claims, repair packets, and handoffs across agents. |\n| **Cloud** | Run hosted checks and preserve shared proof history when local Apple tooling is unavailable. |\n\n## Generate when it helps\n\nGeneration is optional for existing projects. When a feature is easier to\ndescribe as a smaller contract, Axint can emit ordinary Swift and the companion\nmetadata required by the selected Apple surface.\n\n```typescript\nimport { defineIntent, param } from \"@axint/compiler\";\n\nexport default defineIntent({\n name: \"CreateCalendarEvent\",\n title: \"Create Calendar Event\",\n description: \"Creates a calendar event for the user.\",\n domain: \"productivity\",\n params: {\n title: param.string(\"Event title\"),\n date: param.date(\"Event date\"),\n duration: param.duration(\"Event duration\"),\n location: param.string(\"Location\", { required: false }),\n },\n perform: async ({ title, date }) => ({\n success: true,\n message: `Created ${title} on ${date}`,\n }),\n});\n```\n\n```bash\naxint compile create-calendar-event.ts --out ios/Intents/\n```\n\nTypeScript, Python, JSON IR, and the experimental `.axint` authoring surface\nlower into inspectable Apple-native output. The TypeScript pipeline also\nsupports views, widgets, apps, Live Activities, App Enums, UnionValue schemas,\nApp Shortcuts, and extension scaffolds; see the [coverage map](docs/COVERAGE.md)\nfor the implementation and proof boundary of each surface.\n\n## Connect your agent\n\nAxint ships an MCP server for standards-compatible hosts:\n\n```json\n{\n \"mcpServers\": {\n \"axint\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"-p\", \"@axint/compiler\", \"axint-mcp\"]\n }\n }\n}\n```\n\nStart a fresh tool session, then call `axint.status` and `axint.activate` to\nverify that the server and compiler are connected.\n\nThe hosted endpoint at `https://mcp.axint.ai/mcp` supports both established MCP\nclients and the current stateless protocol generation. Compatibility is\ncontinuously checked with official SDK clients; see the\n[protocol compatibility contract](docs/MCP_2026_COMPATIBILITY.md).\n\nFor orchestrators that delegate durable work between agents, Axint also ships\nan authenticated [A2A server](docs/A2A.md). MCP exposes individual tools; A2A\nexposes complete check, diagnosis, proof, and repair-planning tasks with status,\nstreaming updates, cancellation, and source-free result artifacts.\n\n```bash\nnpx -y -p @axint/compiler axint-a2a --project-root /path/to/MyApp\n```\n\nThe Agent Card is served at `/.well-known/agent-card.json`. Loopback use works\nwithout setup; non-loopback deployments require bearer authentication by\ndefault.\n\n