# Axint

> Context tells agents what to build. Axint makes it shippable on Apple. The open-source Apple-native execution layer that turns agent context into validated software — App Intents for Siri, SwiftUI views, WidgetKit widgets, and full app scaffolds.

Axint is authored by Agentic Empire (https://agenticempire.co) and released under the Apache 2.0 license with no CLA. The compiler runs in Node.js 22+, ships an MCP-native server with 13 tools (axint.compile, axint.validate, axint.swift.validate, axint.swift.fix, axint.schema.compile, axint.feature, axint.suggest, and more), and includes a pure-TypeScript in-browser playground at https://axint.ai.

## Positioning

As agents get better context, the bottleneck shifts to execution. Axint is the Apple-native execution layer that turns agent intent into validated software. While the 2026 wave is context management — memory, retrieval, knowledge layers — even with perfect context, Apple-native software is still hard: framework complexity, entitlement rules, plist requirements, widget structure, signing flows. Axint sits right after the context layer and makes everything shippable on Apple. Every intent you ship is automatically both a Siri action and an MCP-callable agent capability.

## Quick facts

- Primary package: `@axint/compiler` on npm (https://www.npmjs.com/package/@axint/compiler)
- Install: `npm install -g @axint/compiler`
- Source: https://github.com/agenticempire/axint
- License: Apache 2.0 (no CLA)
- Language: TypeScript → Swift + Info.plist fragment + .entitlements fragment
- Runtime: Node.js 22+
- Playground: https://axint.ai/#playground (runs in-browser, no server)
- Current version: 0.3.8
- Test coverage: 500+ passing tests across parser, validator, generator, and emit paths
- Diagnostic codes: 150 (AX001–AX522)
- MCP server: bundled, stdio transport, tools for scaffolding and compiling from any MCP client

## Documentation

- [Landing page](https://axint.ai): Overview, live playground, feature tour, FAQ
- [README](https://github.com/agenticempire/axint#readme): Installation, quick start, API reference
- [CHANGELOG](https://github.com/agenticempire/axint/blob/main/CHANGELOG.md): Version history
- [ROADMAP](https://github.com/agenticempire/axint/blob/main/ROADMAP.md): What's next and what's help-wanted
- [CONTRIBUTING](https://github.com/agenticempire/axint/blob/main/CONTRIBUTING.md): How to contribute

## MCP server

Axint ships with `axint-mcp`, a Model Context Protocol server that exposes the compiler to any MCP-compatible LLM client (Claude Desktop, Claude Code, Cursor, Windsurf, etc). The server exposes ten MCP tools plus three built-in prompts, including `axint.scaffold` (generates a TypeScript intent from a natural-language description), `axint.compile` (runs the full pipeline and returns .swift + .plist + .entitlements), `axint.validate` (dry-run validation with diagnostics), `axint.schema.compile` (compiles minimal JSON directly to Swift — the lowest-token path), `axint.templates.list` (lists bundled reference templates), and `axint.templates.get` (returns source code of a specific template by ID). Once connected, an AI coding agent can read a Swift project, draft an intent, compile it, and open a PR — without a human touching Xcode.

## How Axint v0.3.8 works

1. Parse: TypeScript `defineIntent({ ... })` calls are parsed with the real TypeScript compiler API (not regex) into a typed intermediate representation.
2. Validate: 150 diagnostic codes (AX001–AX522) catch invalid App Intent shapes before Swift ever sees them. Return-type inference and default-value sanity checks included.
3. Generate: Idiomatic Swift is emitted — `AppIntent` conformance, `@Parameter` decorators, `LocalizedStringResource` titles, and a `perform()` signature that matches the declared return type.
4. Emit: An Info.plist XML fragment (for `NSAppIntentsDomains`) and a `.entitlements` XML fragment (for the App Intents entitlement) are written alongside the Swift file. Drop all three into Xcode and ship.

## Supported Swift type mappings

- `string` → `String`
- `int` → `Int`
- `double` → `Double`
- `float` → `Float`
- `boolean` → `Bool`
- `date` → `Date`
- `duration` → `Measurement<UnitDuration>`
- `url` → `URL`
- `optional<T>` → `T?`
- Default values and optionality are preserved end-to-end.

## When to use Axint

- Building Siri, Shortcuts, Spotlight, or Apple Intelligence integrations from a TypeScript codebase
- Letting AI coding agents author App Intents via MCP
- Exposing one capability as both a Siri action AND an MCP tool from a single source
- Prototyping App Intents without opening Xcode
- Generating App Intents as part of a cross-platform (React Native / Expo / Capacitor) build pipeline

## When NOT to use Axint

- You need to ship iOS <17 or macOS <14 (App Intents are only available on modern Apple platforms)
- You need UI intents with complex SwiftUI — Axint currently focuses on the non-UI App Intent shape

## Support

- Issues: https://github.com/agenticempire/axint/issues
- Discussions: https://github.com/agenticempire/axint/discussions
- Contact: https://agenticempire.co