Codex Rig is an automated, modular, and minimalist configuration repository tailored specifically for the Codex CLI environment. It provisions global agent instructions, Korean UX enforcement, concise response rules, optional Caveman input compression, Ponytail hooks, git atomic commit protocols, and a focused suite of engineering skills (Waza + local core).
- Automated Symlink Setup (
install.sh): One-command installation linking global instructions and engineering skills directly to~/.codex/and~/.agents/skills/with--dry-runpreview support and orphaned symlink cleanup. - Global Instructions (
~/.codex/AGENTS.md):- Korean UX Enforcement: Mandatory Korean responses for all user-facing explanations, plans, and reviews, while preserving technical symbols, code blocks, and logs in English.
- Using-Superpowers Mandate: Anti-rationalization gate enforcing proactive skill execution (
/think,/hunt,/check, etc.) before code is written. - Response Style: Concise Korean communication without conversational filler.
- Atomic Commit Protocol: Standardized 1-line Conventional Commits upon completing verified units of work.
- Core Engineering Skills Suite:
- Upstream
tw93/Waza(plugins/waza): The gold-standard software engineering workflow skills. - Local core execution skill:
simplify(code refactoring for clarity without changing behavior).
- Upstream
Inspect what symlinks and plugin updates will be executed without modifying the filesystem:
./install.sh --dry-runApply symlinks to ~/.codex/ and ~/.agents/skills/:
./install.shinstall.sh installs Caveman's Codex skills without its SessionStart hook, disables Caveman routing, and installs Ponytail through the Codex plugin marketplace. Preview with ./install.sh --dry-run; set CODEX_RIG_TOKEN_TOOLS=0 to skip these tools. scripts/setup-token-tools.sh can also run on its own.
Restart Codex, then review and trust Ponytail hooks with /hooks. Use caveman codex when you want the optional local input compression proxy; plain codex does not use that proxy.
| Category | Skill | Purpose |
|---|---|---|
| Waza Suite | /think |
Pre-build planning, architecture design & decision validation |
/hunt |
Root cause diagnosis, bug fix & regression investigation | |
/check |
Code review, diff inspection, release gates & project audit | |
/ui |
UI/UX design, visual polish & component styling | |
/write |
Technical documentation, release notes & copywriting | |
/learn |
Deep research, synthesizing material & compiling sources | |
/read |
Extracting web URLs & reading PDF documents | |
/health |
Engineering health audit & config drift check | |
| Local Tool | /simplify |
Refactor code for clarity and maintainability without altering behavior |
/aso |
Audit and improve App Store and Google Play listings | |
/seo-audit |
Technical, on-page, and content SEO audit for websites |
- tw93/Waza: Upstream repository for core engineering workflow skills.
- obra/superpowers: Source reference for
/using-superpowers. - juliusbrussee/caveman: Source reference for
/caveman. - coreyhaines31/marketingskills: Source adapted for
/aso(MIT). - coreyhaines31/marketingskills: Source adapted for
/seo-audit(MIT).
This project is licensed under the MIT License.