Package Exports

litcodex-ai

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (litcodex-ai) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

LitCodex — loop-native agent harness for Codex

litcodex-ai

The LitCodex installer + CLI for Codex — type lit and Codex loops until the goal is verified.

npm version

[!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

Current npm release: litcodex-ai@0.3.20. This release deepens bare Hyperplan invocation context while keeping lit start work as an explicit safe handoff.

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 and phrases — litwork, lit-plan, litgoal, review-work, litresearch, plus lit plan / lit review / lit research / lit goal and the lit start work handoff — alongside a 27-skill library and hook components, all registered as a single Codex plugin.

The bundled public-page-reader skill adds a public-only Node stdlib runtime with safety preflight, unsafe redirect blocking, content validation, trace evidence, and deterministic A/B checks.

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

License

MIT — see LICENSE.