mirror of https://github.com/CharlesWiltgen/Axiom.git synced 2026-09-20 19:58:20 +08:00

Files

T

Charles Wiltgen 46dbd95b28 refactor: migrate build scripts from Deno to Node 24

Node 24 has stable TypeScript stripping (no flags needed), eliminating
the need for Deno as a separate runtime. All scripts now use #!/usr/bin/env node.

- Add .mise.toml pinning Node 24
- Replace regex frontmatter parser with gray-matter in build-codex.ts
- Replace Deno.exit/Deno.args with process equivalents in pre-deploy.ts
- Update package.json scripts from deno run to node
- Remove Deno prerequisite from codex-install docs

2026-03-29 13:00:21 -07:00

4.1 KiB

Raw Blame History

Codex Plugin

Axiom is available as a native plugin for OpenAI Codex, bringing its iOS development skills directly into the Codex CLI, web app, and IDE extensions.

What You Get

The Codex plugin includes 164 specialized skills covering:

SwiftUI — layout, navigation, animations, performance, architecture, debugging
Data — SwiftData, Core Data, GRDB, CloudKit, migrations, Codable
Concurrency — Swift 6, actors, Sendable, async/await, synchronization
Performance — memory leaks, profiling, energy, Instruments workflows
Networking — URLSession, Network.framework, connection diagnostics
Build — Xcode debugging, code signing, build optimization, SPM
Integration — StoreKit, widgets, push notifications, camera, contacts, haptics
Apple Intelligence — Foundation Models, on-device AI, CoreML
Accessibility — VoiceOver, Dynamic Type, WCAG compliance

Prerequisites

Codex CLI or Codex web app
Node.js 24+ — required to build the plugin. Check with node --version

Installation

::: info The Codex plugin marketplace does not yet support third-party submissions. For now, install Axiom locally using one of the methods below. We'll update this page when marketplace publishing is available. :::

Option 1: Personal Marketplace (recommended)

Clone the repo and build the plugin:

git clone https://github.com/CharlesWiltgen/Axiom.git
cd Axiom
npm run build:codex

This creates the axiom-codex/ directory containing the plugin. Use its full path in the config below.

Add to your personal marketplace at ~/.agents/plugins/marketplace.json:

{
  "name": "axiom-local",
  "interface": { "displayName": "Axiom (Local)" },
  "plugins": [
    {
      "name": "axiom",
      "source": { "source": "local", "path": "/path/to/Axiom/axiom-codex" },
      "policy": { "installation": "INSTALLED_BY_DEFAULT" },
      "category": "Development"
    }
  ]
}

Replace /path/to/Axiom with the actual path where you cloned the repo.

Option 2: Project-Scoped

To make Axiom available only within a specific project, add a marketplace file at your repo root:

mkdir -p .agents/plugins

Create .agents/plugins/marketplace.json:

{
  "name": "project-plugins",
  "interface": { "displayName": "Project Plugins" },
  "plugins": [
    {
      "name": "axiom",
      "source": { "source": "local", "path": "/path/to/Axiom/axiom-codex" },
      "policy": { "installation": "INSTALLED_BY_DEFAULT" },
      "category": "Development"
    }
  ]
}

Usage

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"

Updating

Pull the latest changes and rebuild:

cd /path/to/Axiom
git pull
npm run build:codex

The plugin reads skills from disk, so the update takes effect immediately.

Differences from Claude Code

The Codex plugin includes the same skill content as the Claude Code plugin, with a few differences:

Feature	Claude Code	Codex
Skills	164 specialized + 17 routers	164 specialized (Codex has native routing)
Agents	38 autonomous auditors	Not supported in Codex plugins
Commands	12 `/axiom:*` commands	Not supported in Codex plugins
Installation	`/plugin marketplace add`	Local marketplace

Troubleshooting

`axiom-codex/` directory not found

Run the build step first:

cd /path/to/Axiom
npm run build:codex

Skills not appearing in Codex

Verify the path in your marketplace.json points to the axiom-codex/ directory (not the repo root), and that the directory contains .codex-plugin/plugin.json.

Also Available

Claude Code — Full Axiom experience with 38 autonomous agents and 12 commands
MCP Server — Skills in VS Code, Cursor, Gemini CLI, and any MCP-compatible tool; no build step required
Xcode Integration — Direct Xcode MCP bridge for in-editor assistance

4.1 KiB Raw Blame History