Install

Install for Claude Code

In Claude Code, run:

/plugin marketplace add CharlesWiltgen/Axiom

Then install the plugin:

1. Use /plugin to open the plugin menu
2. Search for "axiom"
3. Click "Install"

Verify with /plugin → "Manage and install" — Axiom should be listed.

Install for Codex

npx skills add CharlesWiltgen/Axiom -a codex -g

This installs all 261 skills globally using npx skills. To update later, run npx skills update.

Verifying Installation

Use /plugins in Codex to open the plugin browser — Axiom should appear as installed. You can also run npx skills list -g to see installed skills.

For more installation options (project-scoped, team sharing, MCP server), see the Codex install guide.

MCP Server (Optional)

Axiom's MCP server lets Codex search across all skills by keyword. Add it with one command:

codex mcp add axiom -- npx -y axiom-mcp

Or add it manually to ~/.codex/config.toml:

[mcp_servers.axiom]
command = "npx"
args = ["-y", "axiom-mcp"]

For project-scoped config, use .codex/config.toml in your repo root instead.

Use Skills

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"
"Check my SwiftUI code for performance issues"

Skills cover SwiftUI, concurrency, data persistence, performance, networking, accessibility, Apple Intelligence, build debugging, and more. See the full skill catalog for everything available.

Troubleshooting

Skills Not Activating

Axiom skills route automatically based on iOS-specific keywords in your questions. If skills aren't firing:

1. Use specific terms: "SwiftUI", "build failed", "memory leak", "@MainActor", "SwiftData" trigger routing
2. Use /axiom:ask (Claude Code): Explicitly routes your question to the right skill
3. Restart: Reload Claude Code or Codex

Getting Help

• Report issues
• Discussions

Non-Apple projects

Axiom's session hook auto-detects whether your working directory is part of an Apple project (Xcode project/workspace, Swift package, or Swift sources) and skips its context injection when it isn't — so opening Claude Code in a web, Node, or game-engine project stays clean.

Override with the AXIOM_SESSION_CONTEXT environment variable (it survives plugin updates, unlike editing plugin files):

• AXIOM_SESSION_CONTEXT=always – force Axiom context on (e.g. an Apple project with a non-standard layout the auto-detector misses).
• AXIOM_SESSION_CONTEXT=never – force it off for a given project or shell.

Set it in your shell profile or a project .envrc.

Also Available

• Codex Plugin – Native skills for the OpenAI Codex CLI, web app, and IDE extensions
• Pi Coding Agent – Native skills for the Pi terminal coding agent
• MCP Server – Use Axiom in VS Code, Cursor, Gemini CLI, and any MCP-compatible tool
• Xcode Integration – Direct Xcode MCP bridge setup