Axint

AI agents write 5–15× less code for Apple.

The open-source compiler that turns defineIntent(), defineView(), defineWidget(), and defineApp() calls
into native Swift — App Intents for Siri, SwiftUI views, WidgetKit widgets, and full app scaffolds.

Website · Playground · Quick Start · MCP Server · Discussions

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:

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:

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

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:

• Four compilation targets: intents, views, widgets, apps
• MCP server with JSON schema mode (6 tools)
• 91 diagnostic codes with fix suggestions
• --watch mode with --swift-build
• VS Code / Cursor extension
• Python SDK with native Swift codegen
• SPM build plugin for Xcode + Xcode project plugin
• axint eject for zero-dependency Swift output
• Cross-language IR bridge (TS, Python, JSON)
• 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.

Built by Agentic Empire · axint.ai