ArcKit Codex CLI Extension

Standalone OpenAI Codex CLI extension for ArcKit -- The Enterprise Architecture Governance Harness.

Auto-generated: Files in this directory are generated from plugin commands by python scripts/converter.py. Do not edit them directly -- edit the source in arckit-claude/commands/ and re-run the converter.

Prerequisites

1. ChatGPT Plan: Codex CLI is included with ChatGPT Plus, Pro, Business, Edu, or Enterprise plans
2. Codex CLI installed: Follow installation instructions
3. Git repository: ArcKit works best inside a git repository

Installation

Option 1: CLI (Recommended)

The ArcKit CLI scaffolds a complete project with skills, agents, and MCP config in one step:

# Install the CLI
pip install git+https://github.com/tractorjuice/arc-kit.git
# Or with uv
uv tool install arckit-cli --from git+https://github.com/tractorjuice/arc-kit.git

# Create a new project
arckit init my-project --ai codex
cd my-project
codex

That's it -- no environment variables, no config files. Codex auto-discovers skills from .agents/skills/.

This creates a project with:

• .agents/skills/ -- ArcKit command skills plus 4 reference skills, auto-discovered by Codex
• .codex/agents/ -- 10 agent configs (research, datascout, gov reuse, grants, cloud providers, framework)
• .codex/hooks/ -- ArcKit lifecycle hooks for context injection, secret checks, file guardrails, and MCP approval policy
• .codex/config.toml -- 5 MCP servers, agent roles, and hook wiring
• .arckit/templates/ -- document templates
• .arckit/templates-custom/ -- project-specific template overrides
• .arckit/schemas/ -- handoff schemas for research and scoring workflows
• .arckit/scripts/ -- helper scripts

Option 2: Codex Plugin Bundle

Install ArcKit as a Codex plugin from the standalone marketplace repository:

codex plugin marketplace add tractorjuice/arckit-codex

Enable Codex lifecycle hooks in your user or project config:

[features]
hooks = true
plugin_hooks = true

Restart Codex, open the plugin directory, choose ArcKit Plugins, then install and enable ArcKit. The plugin manifest points to bundled skills, MCP server config, and hooks/hooks.json.

Option 3: Standalone Extension (manual)

This repo can also be used as a standalone extension installed once and shared across projects.

Step 1: Skills (commands)

Copy the skills/ directory into your project or home directory:

# Per-project (auto-discovered from repo root)
cp -r /path/to/arckit-codex/skills/* .agents/skills/

# Or global (auto-discovered from $HOME)
cp -r /path/to/arckit-codex/skills/* ~/.agents/skills/

This makes ArcKit commands available as $arckit-* skills plus 4 reference skills.

Step 2: MCP Servers and Agents

Merge the contents of config.toml into your project Codex configuration:

# If you don't have a project config yet, copy directly
mkdir -p .codex
cp /path/to/arckit-codex/config.toml .codex/config.toml

# If you already have a config, manually merge the [mcp_servers], [agents], and [hooks] sections

Copy the agent prompt files referenced by config.toml:

mkdir -p .codex/agents
cp -r /path/to/arckit-codex/agents/* .codex/agents/

Step 3: Lifecycle Hooks

Copy the Codex hook runner referenced by config.toml: