https://github.com/lidge-jun/codexclaw
cli-jaw-style dev discipline + multi-model subagents for the OpenAI Codex runtime, packaged as a single Codex plugin (PABCD workflow, dev skills, repo-map, recall)
https://github.com/lidge-jun/codexclaw
ai-agents codex codex-plugin codex-skills developer-tools openai-codex pabcd subagents
Last synced: 3 days ago
JSON representation
cli-jaw-style dev discipline + multi-model subagents for the OpenAI Codex runtime, packaged as a single Codex plugin (PABCD workflow, dev skills, repo-map, recall)
- Host: GitHub
- URL: https://github.com/lidge-jun/codexclaw
- Owner: lidge-jun
- License: other
- Created: 2026-07-02T12:04:07.000Z (12 days ago)
- Default Branch: main
- Last Pushed: 2026-07-06T21:32:26.000Z (7 days ago)
- Last Synced: 2026-07-06T23:11:06.317Z (7 days ago)
- Topics: ai-agents, codex, codex-plugin, codex-skills, developer-tools, openai-codex, pabcd, subagents
- Language: TypeScript
- Homepage: https://lidge-jun.github.io/codexclaw/
- Size: 38 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# codexclaw
cli-jaw-style development discipline and multi-model subagents for the **OpenAI Codex runtime**, packaged as a single Codex plugin.
Full documentation: **https://lidge-jun.github.io/codexclaw/**
codexclaw does **not** ship its own agent harness. It reuses the `codex` runtime and layers on top:
- **dev skills**: the cli-jaw `dev-*` family normalized to Codex `SKILL.md` convention (project-agnostic discipline: architecture, debugging, testing, review, security, ...).
- **PABCD workflow**: Plan / Audit / Build / Check / Done, reimplemented as Codex-native skills + hooks + file state (no external orchestrator server).
- **multi-model subagents**: role-based subagents (explorer / reviewer / executor). Per-role model/prompt config is persisted, resolved, and applied to live `spawn_agent` calls through the spawn-wrapper hook (shipped L9).
- **optional opencodex (ocx) provider bridge**: when `ocx` is installed, codexclaw detects its read-only status for catalog/link-bar context. It never runs `ocx ensure`/`sync` or mutates Codex provider config; when `ocx` is absent, codexclaw stays on the native Codex path.
## Layout
```
codexclaw/
├── .agents/plugins/marketplace.json # marketplace registration
├── plugins/codexclaw/
│ ├── .codex-plugin/plugin.json # plugin manifest
│ ├── skills/ # dev-* + pabcd skills
│ ├── hooks/ # session-start / prompt / stop hooks
│ ├── agents/ # subagent role .toml definitions
│ ├── components/ # isolated feature sources (src + dist)
│ │ ├── config-guard/ # plugin enable/disable/status
│ │ ├── cxc-ops/ # doctor + reset
│ │ ├── provider-bridge/ # ocx detect-only / graceful native path
│ │ ├── pabcd-state/ # PABCD FSM + state file + orchestrate CLI
│ │ ├── recall/ # Codex-native session/memory disk-artifact recall
│ │ ├── messenger-bridge/ # messenger integration bridge (cxc serve + adapters)
│ │ ├── skill-search/ # remote dormant-skill search (cxc skill search/show)
│ │ └── subagent-config/ # subagent model/prompt config store + MCP
│ └── gui/ # local web dashboard (Vite + React)
├── cli/ # codexclaw CLI commands
└── devlog/ # _plan (active plans) + _fin (done)
```
## Install (target flow)
```bash
codex plugin marketplace add https://github.com/lidge-jun/codexclaw
codex plugin add codexclaw@codexclaw
```
## GUI
The codexclaw GUI handles subagent configuration (default model vs multi-model), prompt tuning, and, when `ocx` is detected, a link bar to the opencodex dashboard at `localhost:10100`.
## Status
MVP core is implemented and the `mvp_hard` parity hardening track is complete through L20:
L2-L9 and L11-L20 are shipped+tested (L11 docs-site shipped 2026-07-05); L10 is
decision-closed (most is host-native). `cxc orchestrate`
is live, chat-side phase control writes the same `.codexclaw/` state, the IPABCD
footer/status affordance is wired, and the Stop-continuation loop runs under an active Codex
goal with a bounded stagnation guard. Twelve hooks cover session lifecycle, orchestration,
pre/post-tool guards, subagent evidence, and compaction recovery (the 2026-07-05 hook diet
moved seven advisory hooks to `hooks/_deprecated/`, absorbing their rules into the `dev`
skill; the implicit skill set is now `{dev, search, interview, pabcd, recall,
loop}`). Remote dormant-skill search ships as `cxc skill search/show` over cli-jaw-skills,
Hermes, ClawHub, and gh code search. See `devlog/_plan/` for the shipped ledger and
remaining hardening slices.
## License
MIT — see [LICENSE](LICENSE). The repo-map skill vendors RepoMapper (MIT,
(c) 2025 Pete Davis) and Aider-derived tree-sitter queries (Apache-2.0); see
`plugins/codexclaw/skills/repo-map/scripts/NOTICE.md` for third-party notices.