Skip to content

agenticempire/axint

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

116 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Axint

Axint

Axint turns TypeScript and Python into validated Swift for Apple-native features.

Open-source compiler for App Intents, SwiftUI views, WidgetKit widgets, and full apps.
Compact definitions in, validated Swift out.

npm License CI axint MCP server Playground

Website · Playground · Quick Start · MCP Server · Docs · Registry


Why Axint

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

Axint compresses it. One defineIntent() call replaces 50–200 lines of Swift. One defineWidget() replaces an entire WidgetKit stack. The compiler handles the struct conformances, the @Parameter wrappers, the LocalizedStringResource literals — everything an agent would otherwise have to generate token by token.

Four surfaces, one pipeline:

defineIntent()  →  App Intent for Siri & Shortcuts
defineView()    →  SwiftUI view
defineWidget()  →  WidgetKit widget
defineApp()     →  Full app scaffold

The result: teams and AI tools can author Apple-native features in a much smaller surface than hand-written Swift, then validate and ship ordinary generated Swift.


Quick start

npm install -g @axint/compiler

# compile a single file
axint compile my-intent.ts --out ios/Intents/

# or pipe to stdout
npx @axint/compiler compile my-intent.ts --stdout

Intent

import { defineIntent, param } from "@axint/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 "@axint/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 "@axint/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 "@axint/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 surface the same way:

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

Recompiles on every save with 150ms debounce, inline errors, and optional swift build after each successful compile:

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

MCP server

Axint ships an MCP server for Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP client.

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

10 tools + 3 built-in prompts:

Tool What it does
axint.compile Full pipeline: TypeScript → Swift + plist + entitlements
axint.schema.compile Minimal JSON → Swift (token-saving mode for agents)
axint.validate Dry-run validation with diagnostics
axint.feature Generate a complete feature package from a description
axint.suggest Suggest Apple-native features for a domain
axint.scaffold Generate a starter TypeScript intent from a description
axint.swift.validate Validate existing Swift against build-time rules
axint.swift.fix Auto-fix mechanical Swift errors (concurrency, Live Activities)
axint.templates.list List bundled reference templates
axint.templates.get Return the source of a specific template

Built-in prompts:

Prompt What it does
axint.quick-start Get a quick-start guide
axint.create-intent Start a new intent from guided parameters
axint.create-widget Start a new widget from guided parameters

axint.schema.compile is the key optimization — agents send ~20 tokens of JSON and get compiled Swift back directly, skipping TypeScript entirely.


Diagnostics

130 diagnostic codes across the validator surface with fix suggestions and color-coded output:

Range Domain
AX000AX023 Compiler / Parser
AX100AX113 Intent
AX200AX202 Swift output
AX300AX322 View
AX400AX422 Widget
AX500AX522 App
AX700AX749 Swift build rules
AX720AX735 Swift 6 concurrency
AX740AX749 Live Activities
error[AX100]: Intent name "sendMessage" must be PascalCase
  --> src/intents/messaging.ts:5:9
   = help: rename to "SendMessage"

Full reference: docs/ERRORS.md


Type mappings

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

Playground

No install required — axint.ai/#playground runs the same compiler in a server-backed playground, returning Swift live without a local install.


Editor extensions

Extensions for Claude Code, Codex, VS Code / Cursor, Windsurf, JetBrains, Neovim, and Xcode.


Project structure

axint/
├── src/
│   ├── core/        # Parser, validator, generator, compiler, IR
│   ├── sdk/         # defineIntent(), defineView(), defineWidget(), defineApp()
│   ├── mcp/         # MCP server (10 tools + 3 prompts)
│   ├── cli/         # CLI (compile, watch, validate, eject, init, xcode)
│   └── templates/   # 25 bundled reference templates
├── python/          # Python SDK
├── extensions/      # Editor extensions (9 editors)
├── spm-plugin/      # Xcode SPM build plugin
├── tests/           # 543 vitest tests
├── examples/        # Example definitions
└── docs/            # Error reference, assets

What's next

Current priorities — full roadmap in ROADMAP.md:

  • defineExtension() — app extension compilation
  • IntentDialog + richer Apple parameter types
  • swift-format integration for generated output

Contributing

PRs reviewed within 48 hours. Browse good first issue to get started, or see CONTRIBUTING.md.

Apache 2.0, no CLA.


Requirements

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

License

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