axint

<p align="center"> <img src="docs/assets/logo.svg" alt="Axint" width="96" height="96" /> </p>

<h1 align="center">Axint</h1>

<p align="center"> <strong>AI agents write 5–15× less code for Apple.</strong> </p>

<p align="center"> The open-source compiler that turns <code>defineIntent()</code>, <code>defineView()</code>, <code>defineWidget()</code>, and <code>defineApp()</code> calls<br> into native Swift — App Intents for Siri, SwiftUI views, WidgetKit widgets, and full app scaffolds. </p>

<p align="center"> <a href="https://www.npmjs.com/package/@axintai/compiler"><img src="https://img.shields.io/npm/v/@axintai/compiler?color=f05138&label=npm" alt="npm" /></a> <a href="https://github.com/agenticempire/axint/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue" alt="License" /></a> <a href="https://github.com/agenticempire/axint/actions/workflows/ci.yml"><img src="https://github.com/agenticempire/axint/actions/workflows/ci.yml/badge.svg" alt="CI" /></a> <a href="https://glama.ai/mcp/servers/agenticempire/axint"><img src="https://glama.ai/mcp/servers/agenticempire/axint/badges/score.svg" alt="axint MCP server" /></a> <a href="https://axint.ai"><img src="https://img.shields.io/badge/playground-axint.ai-7c3aed" alt="Playground" /></a> </p>

<p align="center"> <a href="https://axint.ai">Website</a> · <a href="https://axint.ai/#playground">Playground</a> · <a href="#quick-start">Quick Start</a> · <a href="#mcp-server">MCP Server</a> · <a href="https://github.com/agenticempire/axint/discussions">Discussions</a> </p>

---

The compression layer for AI agents on Apple

AI coding agents pay per token. Apple's API surfaces — App Intents, SwiftUI, WidgetKit — are verbose. A single widget requires a TimelineEntry, a TimelineProvider, an EntryView, and a Widget struct before you've written a line of business logic.

Axint compresses all of that. One TypeScript definition compiles to idiomatic, production-ready Swift with zero boilerplate. An intent compresses ~4×. A view compresses ~4×. A widget compresses 13×.

┌───────────────────────────────────────────┐
│  defineIntent()  defineView()             │  TypeScript / Python / JSON
│  defineWidget()  defineApp()              │
└───────────────────┬───────────────────────┘
                    │  axint compile
          ┌─────────┼─────────┐─────────┐
          ▼         ▼         ▼         ▼
     ┌────────┐ ┌───────┐ ┌────────┐ ┌──────┐
     │ .swift │ │ .swift│ │ .swift │ │.swift│
     │ .plist │ │       │ │        │ │      │
     │ .entl. │ │       │ │        │ │      │
     └────────┘ └───────┘ └────────┘ └──────┘
     App Intent  SwiftUI   WidgetKit   App
     for Siri    View      Widget      Scaffold

---

Why Axint

• Four Apple surfaces, one compiler. App Intents, SwiftUI views, WidgetKit widgets, and full app scaffolds all compile from the same pipeline.
• Real TypeScript AST parser. Uses the TypeScript compiler API (same as tsc), not regex. Full type fidelity and diagnostics with line/column spans.
• MCP-native with JSON schema mode. Six tools exposed to any MCP client. The axint_compile_from_schema tool accepts minimal JSON (~20 tokens) and returns compiled Swift — AI agents skip TypeScript entirely and save even more tokens.
• Native type fidelity. int → Int, double → Double, date → Date, url → URL, duration → Measurement<UnitDuration>. Default values and optionality preserved end-to-end.
• 91 diagnostic codes (AX000–AX522) with fix suggestions and color-coded output. Intent, entity, view, widget, and app validators each have dedicated error ranges.
• Sub-millisecond compile. The axint.ai playground runs the full compiler in-browser with zero server round-trip.
• 402 tests. Parser, validator, generator, emit paths, views, widgets, apps, watch mode, sandbox, and MCP — all covered.
• Cross-language IR. The intermediate representation is language-agnostic JSON. TypeScript, Python, and raw JSON all feed into the same generator. New language frontends plug in without touching the Swift emitter.
• Apache 2.0, no CLA. Fork it, extend it, ship it.

---

Quick start

npm install -g @axintai/compiler

# Or run without installing
npx @axintai/compiler compile my-intent.ts --stdout

Intent

import { defineIntent, param } from "@axintai/compiler";

export default defineIntent({
  name: "CreateEvent",
  title: "Create Calendar Event",
  description: "Creates a new event in the user's calendar.",
  domain: "productivity",
  params: {
    title: param.string("Event title"),
    date: param.date("Event date"),
    duration: param.duration("Event duration", { default: "1h" }),
    location: param.string("Location", { required: false }),
  },
});

View

import { defineView, prop, state, view } from "@axintai/compiler";

export default defineView({
  name: "EventCard",
  props: {
    title: prop.string(),
    date: prop.date(),
  },
  state: {
    isExpanded: state.boolean(false),
  },
  body: [
    view.vstack({ alignment: "leading", spacing: 8 }, [
      view.text("entry.title"),
      view.conditional("isExpanded", [view.text("entry.date")]),
    ]),
  ],
});

Widget

import { defineWidget, entry, view } from "@axintai/compiler";

export default defineWidget({
  name: "EventCountdown",
  displayName: "Event Countdown",
  description: "Shows time until the next event.",
  families: ["systemSmall", "systemMedium"],
  entry: {
    eventName: entry.string("Untitled"),
    minutesUntil: entry.int(0),
  },
  body: [
    view.vstack({ alignment: "center", spacing: 4 }, [
      view.text("entry.eventName"),
      view.text("entry.minutesUntil"),
    ]),
  ],
});

App

import { defineApp, scene, storage } from "@axintai/compiler";

export default defineApp({
  name: "WeatherApp",
  scenes: [
    scene.windowGroup("WeatherDashboard"),
    scene.settings("SettingsView", { platform: "macOS" }),
  ],
  appStorage: {
    useCelsius: storage.boolean("use_celsius", true),
    lastCity: storage.string("last_city", "Cupertino"),
  },
});

Compile any of them:

axint compile my-intent.ts --out ios/Intents/
axint compile my-view.ts --out ios/Views/
axint compile my-widget.ts --out ios/Widgets/
axint compile my-app.ts --out ios/App/

---

Watch mode

For iterative development, axint watch recompiles on every save:

axint watch ./intents/ --out ios/Intents/ --emit-info-plist --emit-entitlements
axint watch my-intent.ts --out ios/Intents/ --format --swift-build

150ms debounce, inline errors, and optional swift build after each successful compile.

---

MCP server

Axint ships with axint-mcp, a Model Context Protocol server for Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP client.

{
  "mcpServers": {
    "axint": {
      "command": "axint-mcp",
      "args": []
    }
  }
}

Six tools:

Tool	What it does
axint_scaffold	Generate a starter TypeScript intent from a description
axint_compile	Full pipeline: TypeScript → Swift + plist + entitlements
axint_validate	Dry-run validation with diagnostics
axint_compile_from_schema	Minimal JSON → Swift (token-saving mode for AI agents)
axint_list_templates	List bundled reference templates
axint_template	Return the source of a specific template

The schema mode is the key optimization for agents — instead of generating TypeScript and then compiling, agents send ~20 tokens of JSON and get compiled Swift back directly.

---

Diagnostics

91 diagnostic codes across five validators:

Range	Domain
AX000–AX023	Compiler / Parser
AX100–AX113	Intent
AX200–AX202	Swift output
AX300–AX322	View
AX400–AX422	Widget
AX500–AX522	App

error[AX100]: Intent name "sendMessage" must be PascalCase
  --> src/intents/messaging.ts:5:9
   = help: rename to "SendMessage"

See docs/ERRORS.md for the full reference.

---

Supported type mappings

TypeScript	Swift	Default value support
string	String	✓
int	Int	✓
double	Double	✓
float	Float	✓
boolean	Bool	✓
date	Date	—
duration	Measurement<UnitDuration>	✓ (e.g. "1h")
url	URL	—
optional<T>	T?	✓

---

Try it in your browser

No install required: axint.ai/#playground runs the entire compiler in-browser with zero server round-trip.

---

Requirements

• Node.js 22+
• Any OS: macOS, Linux, Windows
• Xcode 15+ (only to ship the generated Swift to an Apple platform)

---

Project structure

axint/
├── src/
│   ├── core/        # Parser, validator, generator, compiler, types, IR
│   ├── sdk/         # defineIntent(), defineView(), defineWidget(), param/prop/state/entry helpers
│   ├── mcp/         # MCP server (6 tools including JSON schema mode)
│   ├── cli/         # axint CLI (compile, watch, validate, eject, init)
│   └── templates/   # Intent template registry
├── python/          # Python SDK with native Swift codegen
├── extensions/
│   └── vscode/      # VS Code / Cursor extension (MCP-backed)
├── spm-plugin/      # Xcode SPM build plugin
├── tests/           # 402 vitest tests
├── examples/        # Example definitions
└── docs/            # Error reference, assets

---

Contributing

We review PRs within 48 hours. Good places to start:

• Browse good first issue issues
• Add a template for a common use case
• Improve diagnostics with better fix suggestions

See CONTRIBUTING.md. Apache 2.0, no CLA.

---

Roadmap

See ROADMAP.md. Highlights:

• [x] Four compilation targets: intents, views, widgets, apps
• [x] MCP server with JSON schema mode (6 tools)
• [x] 91 diagnostic codes with fix suggestions
• [x] --watch mode with --swift-build
• [x] VS Code / Cursor extension
• [x] Python SDK with native Swift codegen
• [x] SPM build plugin for Xcode + Xcode project plugin
• [x] axint eject for zero-dependency Swift output
• [x] Cross-language IR bridge (TS, Python, JSON)
• [x] defineApp() — full app scaffold compilation
• [ ] defineExtension() — app extension compilation
• [ ] Axint Cloud (hosted compilation)

---

License

Apache 2.0 — fork it, extend it, ship it. No CLA.

---

<p align="center"> Built by <a href="https://github.com/agenticempire">Agentic Empire</a> · <a href="https://axint.ai">axint.ai</a> </p>