CharlesWiltgen/Axiom

Axiom – AI‑powered assistant for Apple‑platform development

What it is

• A collection of skills, agents and command‑line tools that plug into AI coding assistants (Claude, Cursor, Gemini, etc.) to give them deep knowledge of modern Apple development – Swift 6, SwiftUI, the upcoming Liquid Glass UI framework, and Apple‑Intelligence APIs.
• The repo ships pre‑written prompts (skills) and autonomous agents that can automatically scan Xcode projects for common problems such as memory leaks, data‑race violations, or build‑system failures.
• It also bundles a few small utilities (xclog, xcsym, xcui, xcprof) that expose simulator/device logs, crash‑symbolication, UI‑automation and performance‑trace data to the AI assistant.

Key components

Component	Purpose
Skills (≈280)	Prompt templates that teach the AI how to answer questions about UI, networking, concurrency, performance, accessibility, etc.
Agents (≈42)	Background workers that can be invoked by the AI to run audits – e.g., memory‑leak detection, concurrency checks, build‑failure diagnostics.
Commands (≈17)	/axiom:* CLI‑style commands that you can type in a chat to trigger the built‑in tools (log capture, crash symbolication, health‑check, …).
xclog	Streams simulator/device console output so the AI can read logs in real time.
xcsym	Symbolicates Apple crash files (.ips, MetricKit, legacy .crash) by locating the correct dSYM automatically.
xcui	Drives the simulator UI via accessibility IDs, dumps the accessibility tree, and validates VoiceOver/Dynamic Type support.
xcprof	Runs xctrace traces and returns a concise performance report without opening Instruments.

How you use it

1. Install the plugin for your preferred AI IDE (Claude Code, Cursor, VS Code MCP, Pi terminal agent, or Xcode integration) – the README provides one‑line commands for each platform.
2. Ask the assistant natural‑language questions (e.g., "How do I fix Swift 6 concurrency errors?") or invoke a command (/axiom:fix-build). The AI loads the relevant skill/agent, runs the underlying tool, and returns a concrete answer or fix.
3. Run audits (/axiom:audit memory, /axiom:health-check) to let the agents automatically scan the project and surface issues before they reach users.

Target audience

• iOS/macOS developers who already use AI coding assistants and want those assistants to understand the nuances of Apple‑specific tooling and APIs.
• Teams looking to reduce debugging time for build failures, memory‑leak detection, and crash analysis.

Documentation & community

• Full docs, skill catalog, and installation guides are hosted at charleswiltgen.github.io/Axiom.
• Community discussion happens on Reddit (r/axiomdev) and via GitHub Issues/Discussions.

Status

• Actively tracking Apple OS 27 beta (the repo lives on a 27.x branch). Existing support for OS 26 and earlier is stable.

---

All details above are taken directly from the repository’s README.