Installation
Install LazyCodex into Codex: prerequisites, the one-line npx install, and signing in to Codex.
LazyCodex installs the OmO agent harness into Codex with a single npx line, no global install. Set up the prerequisites, run the install, and sign in to Codex.
Prerequisites
- Bun
- OpenAI Codex: the Codex app (recommended) or the Codex CLI
LazyCodex runs inside OpenAI Codex, so Codex must be installed and signed in. Pick the surface you want to work in:
The author recommends the Codex app
Both surfaces work, but the Codex app gives the smoothest LazyCodex experience. If you are unsure, install the app.
Install the OpenAI Codex app, sign in, and open your project in it. Because LazyCodex runs inside Codex, the app gives you a full GUI surface for the install and every $command afterwards. Continue to Install below.
Install the OpenAI Codex CLI, then confirm it launches and is signed in. LazyCodex runs inside Codex, so the CLI must be working first. Continue to Install below.
Install
One line. No global install, no npm i -g. Always use npx:
npx lazycodex-ai installThis is shorthand for the OmO installer targeting the Codex platform:
npx --yes --package oh-my-openagent omo install --platform=codexFor a fully autonomous, no-TUI setup, add the autonomous flags:
npx lazycodex-ai install --no-tui --codex-autonomousThe installer wires the OmO harness (commands, skills, hooks, and model routing) into your Codex setup. It is strongly recommended to let an LLM agent run the install and walk the setup for you; the agent handles subscription detection, model selection, and provider auth automatically.
If any of this is fiddly, you do not have to run it yourself: open Codex (CLI or app), give it the lazycodex.ai link, and ask it to install LazyCodex for you. The agent reads the docs and walks the whole setup.
Stuck or curious?
Have a question? Join the LazyCodex Discord and ask Jabdori. You can get setup help there directly.
Authenticate
You authenticate Codex itself, not LazyCodex. With the Codex CLI, sign-in happens as part of Codex's own setup; it prompts you on first run. With the Codex app, you sign in through its UI. There is no separate LazyCodex login command.
Once Codex is signed in, npx lazycodex-ai install handles OmO's side automatically (subscription detection, model selection, and provider routing), so there is nothing extra to authenticate. If you let an LLM agent run the install, it walks all of this for you.
For provider and routing details, see Configuration.