Charles Wiltgen 8a7086351a feat(cursor): port subagent skill awareness to subagentStart
The third and last capability the ledger recorded as downgraded, replaced by a
static preamble in each agent file. Cursor's subagentStart response accepts
additional_context and its query carries subagent_type, which is the only field
the canonical hook reads, so the port is a field rename.

This is additive, not a replacement. The generated preamble carries an agent's
own declared skills; the hook carries the general skill-awareness text gated by
agent type. Both now ship.

Verified as far as a free Cursor plan allows: the hook registers, fires, and
delivers a payload carrying subagent_type, task, and subagent_model — confirmed
against a live Cursor 3.17.8 delegation, which fires subagentStart three times
before refusing to start the subagent with "Named models unavailable. Free
plans can only use Auto." What a free plan cannot show is whether the returned
context reaches a subagent that never starts. The docs and the submission
matrix say so rather than implying full verification. If delivery does not
work, the preamble still carries the declared skills, so the failure mode is
the status quo rather than a regression.

The context guard needed widening: skill awareness is legitimately
multi-paragraph, where the router and crash hints are single-line. Newline and
tab are now permitted, every other control character is still rejected, and the
bound is separate at 8 KiB.
2026-08-23 13:18:08 -07:00
2026-08-14 14:14:31 -07:00
2025-11-30 10:02:02 -08:00

Axiom

Battle-tested skills, agents, and tools for modern Apple OS development — Swift 6, SwiftUI, Liquid Glass, Apple Intelligence, and more. Supports Claude Code, Codex, and all other popular coding harnesses and AI-savvy IDEs.

What is Axiom?

Axiom gives AI coding assistants deep Apple OS development expertise — the kind that prevents data loss from bad migrations, catches memory leaks before users complain, and stops you from spending 30 minutes debugging a zombie xcodebuild process.

  • 273 skills covering UI, data, concurrency, performance, networking, accessibility, and more
  • 42 agents that autonomously scan for issues (memory leaks, concurrency violations, build problems)
  • 17 commands for quick audits and diagnostics
  • xclog — a built-in console capture tool that gives AI assistants access to simulator and device logs
  • xcsym — a built-in crash symbolication tool for .ips, MetricKit, and Apple's legacy .crash text crashes, with automatic dSYM discovery and pattern categorization
  • xcui — a built-in tool to drive and validate the simulator UI and accessibility (tap by accessibility ID, dump the accessibility tree, check VoiceOver and Dynamic Type)
  • xcprof — a built-in tool to record and analyze CPU/performance traces (xctrace) without opening Instruments

Every discipline skill is TDD-tested against real developer pressure scenarios. Learn more about quality.

OS 27 in progress. Axiom is on a 27.x beta that tracks Apple's OS 27 developer betas — OS-27 coverage lands continuously through the beta season. Guidance for OS 26 and earlier stays stable.

Installation

Claude Code (native plugin)

/plugin marketplace add CharlesWiltgen/Axiom

Then search for "axiom" in the /plugin menu and install.

Cursor (native plugin)

Axiom's generated Cursor plugin includes 27 skill routers, 42 agents, 17 /axiom-* commands, advisory hooks, and automatic discovery of its MCP server configuration. See the Cursor install and support guide for the macOS support boundary and local installation steps.

MCP (VS Code, Cursor MCP-only, Gemini CLI, and more)

See the MCP setup guide.

Pi (terminal coding agent)

pi install git:github.com/CharlesWiltgen/Axiom

One command installs the skills plus the /axiom-* commands and hooks. See the Pi setup guide.

Xcode (Claude Agent / Codex)

See the Xcode integration guide.

Getting Started

Skills activate automatically based on your questions. Just ask:

"I'm getting BUILD FAILED in Xcode"
"How do I fix Swift 6 concurrency errors?"
"My app has memory leaks"
"I need to add a database column safely"
"Show me what my app is logging"
"Symbolicate this crash file"

You can also use commands directly:

/axiom:console          # Capture simulator console output
/axiom:analyze-crash    # Parse and triage .ips, MetricKit, or .crash reports
/axiom:fix-build        # Diagnose build failures
/axiom:audit memory     # Scan for memory leaks
/axiom:audit concurrency # Check for data races
/axiom:health-check     # Run all relevant auditors

Documentation

Full documentation, skill catalog, and guides at charleswiltgen.github.io/Axiom.

Community

S
Description
Use when implementing ANY computer vision feature — image analysis, pose detection, person segmentation, subject lifting, text recognition, barcode scanning.
Readme 312 MiB
Languages
Go 35%
TypeScript 33.9%
Python 17.5%
JavaScript 12.4%
Shell 0.9%
Other 0.3%