4.8
CodexClaw

CodexClaw

Desktop Appai-automation#opensource5 ReditVerified

Development discipline + multi-model subagents for OpenAI Codex — 13 dev skills, PABCD workflow, repo map, recall, skill search. Single plugin, no external harness.

SHARE
Screenshots (1)
CodexClaw Screenshot #1
Screenshot 1 of 1

Overview

CodexClaw (cxc) wraps OpenAI's Codex CLI and Desktop with disciplined software engineering guardrails, a deterministic PABCD state machine (Plan → Audit → Build → Check → Done), 13 domain-specific Dev Skills (155 rules, 31 trust-verified hooks), local Recall, tree-sitter PageRank Repo Mapping, and a React multi-model subagent dashboard—all distributed cleanly as a single native Codex plugin with zero external agent harness.

How It Works

CodexClaw operates through structured, deterministic execution stages:

PABCD File-Backed FSM Workflow: Governs development tasks through Plan, Audit, Build, Check, and Done phases with attestation gates and a durable goalplan ledger.
Dev Skill Router Family: Layers 12 domain-specific skills (architecture, security, testing, backend, frontend) with 155 rules and 31 hooks directly on top of OpenAI Codex.
Multi-Model Subagent Dispatch: Assigns explorer, reviewer, executor, and architect roles with per-project and global model/prompt overrides via a React GUI.
Context Recall & Repo Mapping: Searches past disk conversations and memory stores before prompting the user, and computes tree-sitter PageRank code maps for instant orientation.

Key Technical Features & Capabilities

13 Surface-Specific Dev Skills: Covers Architecture, Backend, Frontend, Testing, Security, Debugging, Data, DevOps, Code Review, Scaffolding, Visualizer, and UI/UX Design governed by shared safety gates.
Attestation-Gated PABCD Workflow: Transitions work deterministically across Plan, Audit, Build, Check, and Done phases via cxc orchestrate backed by a durable goalplan ledger.
Multi-Model Subagent Orchestrator: Configures per-role overrides (explorer, reviewer, executor, architect) across live Codex/OpenCodex model catalogs through a local Vite + React GUI.
Tree-Sitter Repo Map & Disk Recall: Runs cxc map for PageRank dependency prioritization, cxc skill search across 3 skill registries, and searches past Codex rollouts before prompting users.

Architecture & Technology Stack

Primary Languages: TypeScript, Node.js (ESM Workspaces), Python (Vendored Repo Map Engine)
Frameworks & UI Runtime: React + Vite Subagent GUI, OpenAI Codex Plugin Spec (31 Hooks, 29 Skills)
Core Analysis & Orchestration: PABCD File-Backed FSM, Tree-Sitter + PageRank Grapher, Subagent Spawn-Wrapper Hook
Supported Platforms: macOS, Linux, Windows (OpenAI Codex Plugin Marketplace)

System Requirements

SpecificationMinimum RequirementRecommended Specification
Operating SystemmacOS, Linux, Windows (OpenAI Codex CLI & Codex Desktop)Latest stable release build
Processor Architecture4-Core x86_64 or Apple Silicon M18-Core Apple Silicon / Core i7+
Memory (RAM)4 GB Unified Memory16 GB+ High-Speed RAM
Disk Space1 GB free SSD storage5 GB+ free SSD storage

Installation & Setup Guide

5 Redit

Native Codex Plugin Installation (2 Lines, Zero Build)

bash
codex plugin marketplace add https://github.com/lidge-jun/codexclaw
codex plugin add codexclaw@codexclaw

Restart Codex and approve the 31 hooks when prompted.

Optional Repo Checkout CLI & GUI

bash
git clone https://github.com/lidge-jun/codexclaw
cd codexclaw
scripts/dev-install.sh
alias cxc='node /path/to/codexclaw/bin/codexclaw.mjs'

Installation & Setup Guide

Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.

How to Use & Workflow

5 Redit
1
Install & Approve Hooks: Add the CodexClaw marketplace plugin, restart Codex, and accept the 31 content-hashed hooks on first run.
2
Drive Structured Phases: Prompt Codex with PABCD tasks (*"Interview me first, then draft a diff-level plan"*) or inspect state directly via cxc orchestrate status.
3
Customize Subagent Models: Open Global Settings or Project Subagents GUI to route architect, reviewer, explorer, or executor roles independently.
4
Orient & Recall Context: Invoke cxc map <dir> on unfamiliar repositories or cxc skill search <query> to load dormant domain skills on demand.

How to Use & Workflow

Mở khóa ứng dụng để xem chi tiết hướng dẫn cài đặt, cấu hình môi trường và vận hành.

Troubleshooting & Common Issues

**Issue: Hooks marked Modified or fail to execute after plugin upgrade.**
*Cause*: Codex hashes hook declarations (hooks/*.json) for security trust across updates.
*Resolution*: Open a fresh Codex session after upgrading and re-approve the modified hooks when prompted.
**Issue: Agent-created threads still prompt for approvals under approval_policy = "never".**
*Cause*: Default approval prompts inside spawned root threads require explicit CodexClaw auto-allow opt-in.
*Resolution*: Add {"permissions":{"agentCreatedThreadAutoAllow":true}} to ~/.codexclaw/config.json.

How to Use & Getting Started

Protected
## Installation & Setup Guide ### Native Codex Plugin Installation (2 Lines, Zero Build) ```bash codex plugin marketplace add https://github.com/lidge-jun/codexclaw codex plugin add codexclaw@codexclaw ``` Restart Codex and approve the 31 hooks when prompted. ### Optional Repo Checkout CLI & GUI ```bash git clone https://github.com/lidge-jun/codexclaw cd codexclaw scripts/dev-install.sh alias cxc='node /path/to/codexclaw/bin/codexclaw.mjs' ```

How to Use & Getting Started

Unlock this app with 5 Redit to access verified runbooks and usage workflows.

Ready to run CodexClaw?

100% Free & Open-Source native desktop software. Star the repository to support development.

More in ai-automation

View all ai-automation apps →
Aside Codemode
4.8

Aside Codemode

One call where Aside used to spend fifty — rg-backed search, Aside-shaped file tools, and batched browser work inside a single sandboxed JavaScript block. On a real folder, 55s of find+grep became ...

AGBrowse
4.8

AGBrowse

Ultimate browser automation toolkit for AI agents. Zero MCP token tax, JS evaluate, vision-click with DPR correction.

CLI JAW
4.9

CLI JAW

2-line install personal AI assistant. 11 AI runtime surfaces (Claude, Codex, Cursor, Gemini, Grok, Antigravity, OpenCode, Copilot), 200+ skills, zero ban risk.