[!NOTE] litcodex is a self-contained CLI: it registers the litcodex Codex plugin and the bare-lit UserPromptSubmit hook with no npx forwarding to any other package. One install, no accounts.

Install

One line, no global install:

npx --yes litcodex-ai install

This registers the marketplace + plugin and installs the hook into Codex, preserving your existing ~/.codex/config.toml — it backs up before any change and never overwrites unrelated keys. Preview the plan first with npx --yes litcodex-ai --dry-run install.

Prefer the litcodex command on your PATH (for doctor / uninstall / loop later)? Install globally instead:

npm install -g litcodex-ai
litcodex install

Commands

| Command | Purpose | | --- | --- | | litcodex install [--dry-run] | Register the LitCodex Codex plugin + hook (dry-run prints the plan, mutates nothing) | | litcodex doctor | Diagnose the installation | | litcodex uninstall | Remove the LitCodex registration | | litcodex config migrate | Apply the managed Codex config keys (backup-before-write) | | litcodex loop <create\|status\|run\|checkpoint\|record-evidence\|doctor> | Drive the lit-loop runtime | | litcodex hook user-prompt-submit | The Codex hook entrypoint (invoked by the host) |

How it works

Once installed, typing a bare lit in Codex activates lit-loop — an evidence-bound, autonomous work loop that decomposes the task, records real evidence per step, and keeps going until every success criterion passes. Durable loop state lives under .litcodex/lit-loop/ in your project (brief.md, goals.json, ledger.jsonl, evidence/).

LitCodex also ships a sibling family of triggers — litwork, lit-plan, litgoal — plus a 20-skill library and hook components, all registered as a single Codex plugin.

[!TIP] See the repository README for the full quickstart, the mode family, the loop model, and troubleshooting.

License

MIT — see LICENSE.