Skip to content

The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.

feat: add lazycodex-ai npm install alias

YeonGyu-Kim35fb1539cb46
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 00000000..09aac3c3
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yeongyu Kim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index f2b45f0e..ddc8ec5e 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
<div align="center">
- <img src=".github/assets/lazycodex-logo.png" alt="LazyCodex" width="280">
+ <img src=".github/assets/lazycodex-logo.png" alt="LazyCodex AI" width="280">
- <h1>LazyCodex</h1>
+ <h1>LazyCodex AI</h1>
<p><strong>Codex for no-brainers.</strong><br />
You don't need to think. Just prompt with <code>ultrawork</code>.</p>
@@ -32,18 +32,18 @@
One line. No global install, no `npm i -g`. Always use `bunx`:
```bash
-bunx lazycodex install
+bunx lazycodex-ai install
```
-This is shorthand for `bunx omo install --platform=codex`. For a fully autonomous, no-TUI setup:
+This is shorthand for `bunx --package oh-my-openagent omo install --platform=codex`. For a fully autonomous, no-TUI setup:
```bash
-bunx lazycodex install --no-tui --codex-autonomous
+bunx lazycodex-ai install --no-tui --codex-autonomous
```
## ⚡ Commands
-LazyCodex adds three workflow commands to your OpenCode session:
+LazyCodex AI adds three workflow commands to your OpenCode session:
| Command | Syntax | What it does |
| --- | --- | --- |
@@ -57,13 +57,13 @@ Full documentation lives at [lazycodex.ai/docs](https://lazycodex.ai/docs).
## 💤 What is this?
-**LazyCodex** is the **lazy way** to get [OmO (oh-my-openagent)](https://github.com/code-yeongyu/oh-my-openagent) up and running.
+**LazyCodex AI** is the **lazy way** to get [OmO (oh-my-openagent)](https://github.com/code-yeongyu/oh-my-openagent) up and running.
Think [LazyVim](https://github.com/LazyVim/LazyVim) for [lazy.nvim](https://github.com/folke/lazy.nvim), but for Codex.
-OmO is the best agent harness: discipline agents, parallel orchestration, multi-model routing, skills, hooks, and more. LazyCodex wraps it so you don't have to think about setup.
+OmO is the best agent harness: discipline agents, parallel orchestration, multi-model routing, skills, hooks, and more. LazyCodex AI wraps it so you don't have to think about setup.
-> _"LazyVim made Neovim usable for the rest of us. LazyCodex does the same for Codex."_
+> _"LazyVim made Neovim usable for the rest of us. LazyCodex AI does the same for Codex."_
## 🧩 What you get
@@ -78,7 +78,7 @@ OmO is the best agent harness: discipline agents, parallel orchestration, multi-
## 🏗️ Architecture
-LazyCodex is a thin distribution layer. The core engine is [oh-my-openagent (OmO)](https://github.com/code-yeongyu/oh-my-openagent), included as a submodule under `src/`.
+LazyCodex AI is a thin distribution layer. The core engine is [oh-my-openagent (OmO)](https://github.com/code-yeongyu/oh-my-openagent), included as a submodule under `src/`.
```
lazycodex/
@@ -91,11 +91,11 @@ lazycodex/
└── ...
```
-LazyCodex is part of the [omo.dev](https://omo.dev) project. **omo in Codex**, packaged for the lazy.
+LazyCodex AI is part of the [omo.dev](https://omo.dev) project. **omo in Codex**, packaged for the lazy.
## 👷 Maintainer
-LazyCodex is maintained by **Jobdori**, the AI assistant that builds and ships [OmO](https://github.com/code-yeongyu/oh-my-openagent) in real-time.
+LazyCodex AI is maintained by **Jobdori**, the AI assistant that builds and ships [OmO](https://github.com/code-yeongyu/oh-my-openagent) in real-time.
<div align="center">
diff --git a/bin/lazycodex-ai.js b/bin/lazycodex-ai.js
new file mode 100755
index 00000000..eb73ed90
--- /dev/null
+++ b/bin/lazycodex-ai.js
@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process"
+
+const args = process.argv.slice(2)
+const dryRun = args[0] === "--dry-run"
+const forwardedArgs = dryRun ? args.slice(1) : args
+const commandArgs =
+ forwardedArgs[0] === "install"
+ ? ["--package", "oh-my-openagent", "omo", "install", "--platform=codex", ...forwardedArgs.slice(1)]
+ : ["--package", "oh-my-openagent", "omo", ...forwardedArgs]
+
+if (dryRun) {
+ console.log(["bunx", ...commandArgs].join(" "))
+ process.exit(0)
+}
+
+const result = spawnSync("bunx", commandArgs, {
+ stdio: "inherit",
+})
+
+if (result.error) {
+ console.error(result.error.message)
+ process.exit(1)
+}
+
+process.exit(result.status ?? 1)
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 00000000..45948384
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,16 @@
+{
+ "name": "lazycodex-ai",
+ "version": "0.2.0",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "lazycodex-ai",
+ "version": "0.2.0",
+ "license": "MIT",
+ "bin": {
+ "lazycodex-ai": "bin/lazycodex-ai.js"
+ }
+ }
+ }
+}
diff --git a/package.json b/package.json
new file mode 100644
index 00000000..229bd47b
--- /dev/null
+++ b/package.json
@@ -0,0 +1,34 @@
+{
+ "name": "lazycodex-ai",
+ "version": "0.2.0",
+ "description": "Codex install alias for oh-my-openagent. Run `bunx lazycodex-ai install` to set up the Codex platform.",
+ "type": "module",
+ "bin": {
+ "lazycodex-ai": "bin/lazycodex-ai.js"
+ },
+ "files": [
+ "bin",
+ "README.md",
+ "LICENSE"
+ ],
+ "scripts": {
+ "test": "node --test test/lazycodex-ai-bin.test.mjs",
+ "pack:dry-run": "npm pack --dry-run"
+ },
+ "keywords": [
+ "codex",
+ "oh-my-openagent",
+ "ai-agents",
+ "orchestration"
+ ],
+ "author": "Yeongyu Kim",
+ "license": "MIT",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/code-yeongyu/lazycodex.git"
+ },
+ "bugs": {
+ "url": "https://github.com/code-yeongyu/lazycodex/issues"
+ },
+ "homepage": "https://lazycodex.ai"
+}
diff --git a/test/lazycodex-ai-bin.test.mjs b/test/lazycodex-ai-bin.test.mjs
new file mode 100644
index 00000000..7a5611c4
--- /dev/null
+++ b/test/lazycodex-ai-bin.test.mjs
@@ -0,0 +1,59 @@
+import assert from "node:assert/strict"
+import { existsSync, readFileSync } from "node:fs"
+import { join } from "node:path"
+import { spawnSync } from "node:child_process"
+import { describe, it } from "node:test"
+
+const root = new URL("..", import.meta.url).pathname
+const packageJsonPath = join(root, "package.json")
+const binPath = join(root, "bin", "lazycodex-ai.js")
+
+describe("lazycodex-ai npm package", () => {
+ it("maps the package name and bin to lazycodex-ai", () => {
+ // given
+ assert.equal(existsSync(packageJsonPath), true, "root package.json must exist")
+
+ // when
+ const manifest = JSON.parse(readFileSync(packageJsonPath, "utf8"))
+
+ // then
+ assert.equal(manifest.name, "lazycodex-ai")
+ assert.equal(manifest.version, "0.2.0")
+ assert.equal(manifest.bin?.["lazycodex-ai"], "bin/lazycodex-ai.js")
+ assert.equal(manifest.private, undefined)
+ })
+
+ it("dry-runs install through oh-my-openagent with the Codex platform default", () => {
+ // given
+ assert.equal(existsSync(binPath), true, "lazycodex-ai bin must exist")
+
+ // when
+ const result = spawnSync(
+ process.execPath,
+ [binPath, "--dry-run", "install", "--no-tui", "--codex-autonomous"],
+ { cwd: root, encoding: "utf8" },
+ )
+
+ // then
+ assert.equal(result.status, 0, result.stderr)
+ assert.equal(
+ result.stdout.trim(),
+ "bunx --package oh-my-openagent omo install --platform=codex --no-tui --codex-autonomous",
+ )
+ })
+
+ it("dry-runs non-install commands through oh-my-openagent", () => {
+ // given
+ assert.equal(existsSync(binPath), true, "lazycodex-ai bin must exist")
+
+ // when
+ const result = spawnSync(process.execPath, [binPath, "--dry-run", "doctor"], {
+ cwd: root,
+ encoding: "utf8",
+ })
+
+ // then
+ assert.equal(result.status, 0, result.stderr)
+ assert.equal(result.stdout.trim(), "bunx --package oh-my-openagent omo doctor")
+ })
+})