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

Files

T

Charles Wiltgen 51d9976610 fix: address code review issues in Codex build script and docs

Build script:
- Escape backslashes before quotes in YAML output
- Handle Windows-style line endings in frontmatter parsing
- Use dir.name (not fm.name) for display_name consistency
- Warn when openai.yaml is skipped due to missing frontmatter
- Compute actual skipped count from filesystem, not set size

Docs:
- Add Deno prerequisite
- Clarify that axiom-codex/ is created by the build step
- Remove unverified $skill-name invocation syntax
- Add Troubleshooting section
- Improve Also Available with relationship explanations
- Change "Not yet supported" to "Not supported" for accuracy

2026-03-29 11:28:12 -07:00

4.3 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
Deno — required to build the plugin. Check with deno --version or install from deno.com

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

`deno: command not found`

Install Deno from deno.com:

curl -fsSL https://deno.land/install.sh | sh

`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.3 KiB Raw Blame History