codex-dots

Reusable Codex bundles.

Bundles

• hooks/fresh-deps: blocks dependency edits that use too-new package versions, stale versions, or known vulnerable versions before apply_patch lands. It also gives non-blocking advisories for unchanged dependencies in touched dependency files.
• hooks/unslop-writing: reports cliché candidates after prose edits and before a turn stops.
• hooks/jev-stop: asks Jev whether a final response leaves authorized work unfinished, using redacted conversation text sent to TypeSafe.
• skills/github-issue-reporter: searches for duplicate GitHub issues, follows live issue templates, drafts exact issue text, and waits for approval before posting.
• skills/quick-grill: adds a short preflight and approval step before work.
• skills/code-explainer: inspects live implementation code and creates source-backed, Notion-style standalone HTML feature explainers.

Install

Hook bundle, replacing <bundle> with fresh-deps, unslop-writing, or jev-stop:

1. Copy hooks/<bundle>/.codex/hooks/* into your target repo's .codex/hooks/.
2. Merge hooks/<bundle>/hooks.json into your target repo's .codex/hooks.json.
3. Enable hooks and trust the target project:

[features]
hooks = true

Jev also requires a TypeSafe API key. Read its setup and privacy notes before enabling it.

Skill bundle:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R skills/quick-grill "${CODEX_HOME:-$HOME/.codex}/skills/"
cp -R skills/github-issue-reporter "${CODEX_HOME:-$HOME/.codex}/skills/"
cp -R skills/code-explainer "${CODEX_HOME:-$HOME/.codex}/skills/"

quick-grill works with the available preference-question tool or concise plain-text questions. Plan approval uses the environment's permitted approval mechanism; no feature flag is required.

Verify

Run hook tests from this repository root:

uv run --no-project --python '>=3.11' python hooks/fresh-deps/tests/test-fresh-deps.py
node --test hooks/unslop-writing/tests/*.test.mjs
node hooks/unslop-writing/.codex/hooks/cliche-detector.mjs --self-test
uv run --no-project --python '>=3.11' python hooks/jev-stop/tests/test-jev-stop.py

License

0BSD. See LICENSE.