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, token-saving terse response modes (caveman), 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. - Caveman Mode: Terse, high-density, token-saving communication without conversational fluff.
- 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 skills:
using-superpowers,caveman,simplify,using-atomic-commit.
- 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.sh| 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 | |
| Core Drivers | /using-superpowers |
Meta-skill enforcing proactive skill invocation before action |
/caveman |
Terse communication intensity mode (lite, full, ultra) |
|
/simplify |
Refactor code for clarity and maintainability without altering behavior | |
/using-atomic-commit |
Enforces 1-line atomic commits conforming to Conventional Commits v1.0.0 |
- tw93/Waza: Upstream repository for core engineering workflow skills.
- obra/superpowers: Source reference for
/using-superpowers. - juliusbrussee/caveman: Source reference for
/caveman.
This project is licensed under the MIT License.