docs(omo-codex): clarify sisyphuslabs marketplace install
This commit is contained in:
YeonGyu-Kim
+2
-2
@@ -346,13 +346,13 @@ oh-my-openagent を削除するには:
|
||||
# プラグインがロードされなくなっているはずです
|
||||
```
|
||||
|
||||
4. **omo-codex (Codex アダプター) を削除する**
|
||||
4. **omo-codex (Codex CLI Light エディション) を削除する**
|
||||
|
||||
```bash
|
||||
rm -rf ~/.codex/plugins/cache/sisyphuslabs
|
||||
```
|
||||
|
||||
その後 `~/.codex/config.toml` を開き、`[plugins."omo@sisyphuslabs"]` ブロックと `[hooks.state.\"omo@...\"]` ブロックを削除してください。
|
||||
その後 `~/.codex/config.toml` を開き、`[marketplaces.sisyphuslabs]`、`[plugins."omo@sisyphuslabs"]`、`[hooks.state."omo@sisyphuslabs:..."]` ブロックを削除してください。
|
||||
|
||||
## Features
|
||||
|
||||
|
||||
+2
-2
@@ -347,13 +347,13 @@ oh-my-openagent를 제거하려면:
|
||||
# 더 이상 플러그인이 로드되지 않아야 합니다
|
||||
```
|
||||
|
||||
4. **omo-codex (Codex 어댑터) 제거**
|
||||
4. **omo-codex (Codex CLI Light 에디션) 제거**
|
||||
|
||||
```bash
|
||||
rm -rf ~/.codex/plugins/cache/sisyphuslabs
|
||||
```
|
||||
|
||||
그런 다음 `~/.codex/config.toml`을 열어 `[plugins."omo@sisyphuslabs"]` 블록과 `[hooks.state.\"omo@...\"]` 블록들을 삭제하세요.
|
||||
그런 다음 `~/.codex/config.toml`을 열어 `[marketplaces.sisyphuslabs]`, `[plugins."omo@sisyphuslabs"]`, `[hooks.state."omo@sisyphuslabs:..."]` 블록들을 삭제하세요.
|
||||
|
||||
## Features
|
||||
|
||||
|
||||
@@ -113,10 +113,10 @@ Pick the edition(s) you want.
|
||||
| You want | Run | What lands on disk |
|
||||
| :--- | :--- | :--- |
|
||||
| **Ultimate** (OpenCode) | `bunx omo install` (TUI walks you through it) | Plugin registered in `opencode.json` + agent/model config + provider auth prompts |
|
||||
| **Light** (Codex CLI) | `bunx omo install --platform=codex` | `~/.codex/plugins/cache/sisyphuslabs/omo/` + `~/.codex/config.toml` plugin block + `~/.local/bin/omo-*` |
|
||||
| **Light** (Codex CLI) | `bunx omo install --platform=codex` or `bunx lazycodex install` | `~/.codex/plugins/cache/sisyphuslabs/omo/` + `~/.codex/config.toml` marketplace/plugin blocks + `~/.local/bin/omo-*` |
|
||||
| **Both** | `bunx omo install --platform=both` | Both of the above |
|
||||
|
||||
`--platform` defaults to `opencode` (Ultimate). The `bunx lazycodex install` alias is a one-letter-cheaper shortcut for `bunx omo install --platform=codex` — use whichever reads cleaner.
|
||||
`--platform` defaults to `opencode` (Ultimate). The `bunx lazycodex install` alias is a shortcut for `bunx omo install --platform=codex`; use whichever reads cleaner.
|
||||
|
||||
### For Humans
|
||||
|
||||
@@ -133,6 +133,8 @@ If you only want the **Light edition** (Codex CLI), the installer asks no questi
|
||||
|
||||
```bash
|
||||
bunx omo install --platform=codex
|
||||
# equivalent:
|
||||
bunx lazycodex install
|
||||
```
|
||||
|
||||
> **Do not** use `npm install -g`, `bun add -g`, or `bun install -g`. Global installation is not officially supported — oh-my-openagent is a plugin that must resolve from where OpenCode/Codex loads plugins. Always invoke via `bunx`.
|
||||
@@ -145,22 +147,22 @@ Fetch the full guide and follow it step by step:
|
||||
curl -fsSL https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
|
||||
```
|
||||
|
||||
The guide covers: platform selection, the subscription interview, provider authentication (Anthropic / Gemini / Copilot / Z.ai / OpenCode Zen), the agent-to-model matching matrix, modes (`ultrawork`, `search`, `analyze`, `team`, `hyperplan`), slash commands, the Codex adapter's 5 components, Team Mode, and uninstall. Don't summarize it — read it end to end.
|
||||
The guide covers: platform selection, the subscription interview, provider authentication (Anthropic / Gemini / Copilot / Z.ai / OpenCode Zen), the agent-to-model matching matrix, modes (`ultrawork`, `search`, `analyze`, `team`, `hyperplan`), slash commands, the Light edition's 5 Codex components, Team Mode, and uninstall. Don't summarize it; read it end to end.
|
||||
|
||||
### Note on package and command names
|
||||
|
||||
The published npm package and CLI binary are still named `oh-my-opencode` (dual-published as `oh-my-openagent` during the rename transition). Inside `opencode.json`, the compatibility layer prefers the plugin entry `oh-my-openagent`, while legacy `oh-my-opencode` entries still load with a warning. Plugin config files still commonly use `oh-my-opencode.json[c]`; both legacy and renamed basenames are recognized.
|
||||
|
||||
All four `bunx` aliases — `oh-my-opencode`, `oh-my-openagent`, `omo`, `lazycodex` — invoke the same compiled CLI. `omo` is the recommended short form for documentation and prompts. `lazycodex` is a single-purpose shortcut: `bunx lazycodex install` is exactly equivalent to `bunx omo install --platform=codex`.
|
||||
All four `bunx` aliases - `oh-my-opencode`, `oh-my-openagent`, `omo`, `lazycodex` - invoke the same compiled CLI. `omo` is the recommended short form for documentation and prompts. `lazycodex` is a single-purpose npm/bin alias: `bunx lazycodex install` is exactly equivalent to `bunx omo install --platform=codex`. It is not the Codex marketplace name. Codex sees marketplace `sisyphuslabs` and plugin `omo`, enabled as `omo@sisyphuslabs`.
|
||||
|
||||
### Telemetry
|
||||
|
||||
Anonymous telemetry is enabled by default to track active installations (DAU/WAU/MAU). For both products, a single event is sent **at most once per UTC day per machine** using a SHA256-hashed installation identifier (never the raw hostname), and PostHog person profiles are not created. The main plugin emits `oh_my_openagent_daily_active`; the Codex adapter emits `omo_codex_daily_active` from two sources (`install_completed` and `session_start`).
|
||||
Anonymous telemetry is enabled by default to track active installations (DAU/WAU/MAU). For both products, a single event is sent **at most once per UTC day per machine** using a SHA256-hashed installation identifier (never the raw hostname), and PostHog person profiles are not created. The main plugin emits `oh_my_openagent_daily_active`; the Codex CLI Light edition emits `omo_codex_daily_active` from two sources (`install_completed` and `session_start`).
|
||||
|
||||
Opt out per product:
|
||||
|
||||
- Main plugin: `OMO_DISABLE_POSTHOG=1` or `OMO_SEND_ANONYMOUS_TELEMETRY=0`
|
||||
- Codex adapter: `OMO_CODEX_DISABLE_POSTHOG=1` or `OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0` (the global flags also disable Codex)
|
||||
- Codex CLI Light edition: `OMO_CODEX_DISABLE_POSTHOG=1` or `OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0` (the global flags also disable Codex)
|
||||
|
||||
See [Privacy Policy](docs/legal/privacy-policy.md) and [Terms of Service](docs/legal/terms-of-service.md).
|
||||
|
||||
@@ -392,13 +394,13 @@ To remove oh-my-openagent:
|
||||
# Plugin should no longer be loaded
|
||||
```
|
||||
|
||||
4. **Remove omo-codex (Codex adapter)**
|
||||
4. **Remove omo-codex (Codex CLI Light edition)**
|
||||
|
||||
```bash
|
||||
rm -rf ~/.codex/plugins/cache/sisyphuslabs
|
||||
```
|
||||
|
||||
Then open `~/.codex/config.toml` and remove the `[plugins."omo@sisyphuslabs"]` block and any `[hooks.state.\"omo@...\"]` blocks.
|
||||
Then open `~/.codex/config.toml` and remove `[marketplaces.sisyphuslabs]`, `[plugins."omo@sisyphuslabs"]`, and any `[hooks.state."omo@sisyphuslabs:..."]` blocks.
|
||||
|
||||
## Features
|
||||
|
||||
|
||||
+2
-2
@@ -345,13 +345,13 @@ project/
|
||||
# Плагин больше не должен загружаться
|
||||
```
|
||||
|
||||
4. **Удалите omo-codex (Codex-адаптер)**
|
||||
4. **Удалите omo-codex (Codex CLI Light edition)**
|
||||
|
||||
```bash
|
||||
rm -rf ~/.codex/plugins/cache/sisyphuslabs
|
||||
```
|
||||
|
||||
Затем откройте `~/.codex/config.toml` и удалите блок `[plugins."omo@sisyphuslabs"]` и все блоки `[hooks.state.\"omo@...\"]`.
|
||||
Затем откройте `~/.codex/config.toml` и удалите блоки `[marketplaces.sisyphuslabs]`, `[plugins."omo@sisyphuslabs"]` и `[hooks.state."omo@sisyphuslabs:..."]`.
|
||||
|
||||
## Функции
|
||||
|
||||
|
||||
+2
-2
@@ -346,13 +346,13 @@ Agent 会自动顺藤摸瓜加载对应的 Context，免去了你所有的手动
|
||||
# 这个时候就应该没有任何关于插件的输出信息了
|
||||
```
|
||||
|
||||
4. **移除 omo-codex（Codex 适配器）**
|
||||
4. **移除 omo-codex（Codex CLI Light 版本）**
|
||||
|
||||
```bash
|
||||
rm -rf ~/.codex/plugins/cache/sisyphuslabs
|
||||
```
|
||||
|
||||
然后打开 `~/.codex/config.toml`，删除 `[plugins."omo@sisyphuslabs"]` 区块，以及所有 `[hooks.state.\"omo@...\"]` 区块。
|
||||
然后打开 `~/.codex/config.toml`，删除 `[marketplaces.sisyphuslabs]`、`[plugins."omo@sisyphuslabs"]` 以及所有 `[hooks.state."omo@sisyphuslabs:..."]` 区块。
|
||||
|
||||
## Features
|
||||
|
||||
|
||||
+20
-16
@@ -10,10 +10,10 @@ Most users want **Ultimate**. Pick **Light** if you are already invested in Code
|
||||
| You want | Run | Lands on disk |
|
||||
| :--- | :--- | :--- |
|
||||
| Ultimate (OpenCode) | `bunx omo install` (TUI walks you through it) | Plugin registered in `opencode.json`, agent/model config, provider auth |
|
||||
| Light (Codex CLI) | `bunx omo install --platform=codex` (no questions) | `~/.codex/plugins/cache/...`, `~/.codex/config.toml` plugin block, `~/.local/bin/omo-*` |
|
||||
| Light (Codex CLI) | `bunx omo install --platform=codex` or `bunx lazycodex install` (no questions) | `~/.codex/plugins/cache/sisyphuslabs/omo/`, `~/.codex/config.toml` marketplace/plugin blocks, `~/.local/bin/omo-*` |
|
||||
| Both | `bunx omo install --platform=both` | Both of the above |
|
||||
|
||||
`--platform` defaults to `opencode` (Ultimate). The `bunx lazycodex install` alias is a shortcut for `bunx omo install --platform=codex` — same compiled CLI, different default.
|
||||
`--platform` defaults to `opencode` (Ultimate). The `bunx lazycodex install` alias is a shortcut for `bunx omo install --platform=codex`: same compiled CLI, different default. `lazycodex` is a repo/npm/bin alias, not the Codex marketplace name.
|
||||
|
||||
## For Humans
|
||||
|
||||
@@ -38,7 +38,7 @@ bunx omo install --platform=codex
|
||||
bunx lazycodex install
|
||||
```
|
||||
|
||||
It writes only to `~/.codex/`. No OpenCode interaction, no provider flags.
|
||||
It writes only to `~/.codex/`. No OpenCode interaction, no provider flags. Codex config will register marketplace `sisyphuslabs` from `https://github.com/code-yeongyu/lazycodex.git` and enable plugin `omo@sisyphuslabs`.
|
||||
|
||||
### A note on direct install
|
||||
|
||||
@@ -178,7 +178,7 @@ bunx oh-my-openagent install \
|
||||
[--skip-auth]
|
||||
```
|
||||
|
||||
`--platform` defaults to `opencode` if omitted. Subscription flags only apply when `--platform` is `opencode` or `both` — they are ignored under `--platform=codex` because the Codex adapter does not write OpenCode model config.
|
||||
`--platform` defaults to `opencode` if omitted. Subscription flags only apply when `--platform` is `opencode` or `both`. They are rejected under `--platform=codex` because the Light edition does not write OpenCode model config.
|
||||
|
||||
**Examples:**
|
||||
|
||||
@@ -205,14 +205,14 @@ bunx oh-my-openagent install \
|
||||
bunx oh-my-openagent install --no-tui --platform=opencode --claude=no --openai=no --gemini=no --copilot=no --opencode-go=yes
|
||||
```
|
||||
|
||||
**About the `lazycodex` bin name.** `lazycodex` is an alias for the same compiled CLI. The only difference: `lazycodex install` defaults `--platform=codex` instead of `opencode`. You can still pass `--platform=both` to override. Use whichever name reads cleaner.
|
||||
**About the `lazycodex` bin name.** `lazycodex` is an alias for the same compiled CLI and the Git repository that hosts the marketplace bundle. The only CLI difference is that `lazycodex install` defaults `--platform=codex` instead of `opencode`. You can still pass `--platform=both` to override. The Codex marketplace name is `sisyphuslabs`, and the plugin name is `omo`.
|
||||
|
||||
**What the installer does:**
|
||||
|
||||
| Platform | Writes |
|
||||
|----------|--------|
|
||||
| `opencode`, `both` | Registers `"oh-my-openagent"` in `opencode.json` `plugin` array. Generates agent → model mappings into `~/.config/opencode/oh-my-openagent.jsonc`. |
|
||||
| `codex`, `both` | Copies `packages/omo-codex/plugin/` into `~/.codex/plugins/cache/sisyphuslabs/omo/<version>/`. Runs `npm install` + `npm run build` inside. Symlinks `~/.local/bin/omo-*` (or `$CODEX_LOCAL_BIN_DIR/omo-*`) for each of the 5 components. Computes SHA256 trusted-hashes for every hook and writes the `[plugins."omo@..."]` + `[hooks.state."omo@..."]` blocks into `~/.codex/config.toml`. |
|
||||
| `codex`, `both` | Copies `packages/omo-codex/plugin/` into `~/.codex/plugins/cache/sisyphuslabs/omo/<version>/`. Runs `npm install` + `npm run build` inside. Symlinks `~/.local/bin/omo-*` (or `$CODEX_LOCAL_BIN_DIR/omo-*`) for each of the 5 components. Computes SHA256 trusted-hashes for every hook and writes `[marketplaces.sisyphuslabs]` with git source `https://github.com/code-yeongyu/lazycodex.git`, `[plugins."omo@sisyphuslabs"]`, and `[hooks.state."omo@sisyphuslabs:..."]` blocks into `~/.codex/config.toml`. |
|
||||
|
||||
Both halves are independent and idempotent — re-running is safe.
|
||||
|
||||
@@ -229,12 +229,15 @@ bunx oh-my-openagent doctor
|
||||
|
||||
`doctor` runs six categories of checks: **System** (binary version, plugin registration), **Config** (JSONC + Zod schema), **TUI Plugin**, **Tools** (AST-grep, LSP, GitHub CLI, comment-checker), **Models** (cache, per-agent resolution, fallback chain availability), and **Team Mode** (if enabled). Exit code: `0` = ok, `1` = errors, `2` = warnings only.
|
||||
|
||||
#### Verify Codex adapter (skip if platform=opencode)
|
||||
#### Verify Codex CLI Light edition (skip if platform=opencode)
|
||||
|
||||
```bash
|
||||
# Plugin cache present?
|
||||
ls ~/.codex/plugins/cache/sisyphuslabs/omo/
|
||||
|
||||
# Marketplace source is the lazycodex repo?
|
||||
grep -A4 'marketplaces.sisyphuslabs' ~/.codex/config.toml
|
||||
|
||||
# Codex config has the plugin block?
|
||||
grep -A2 'omo@sisyphuslabs' ~/.codex/config.toml
|
||||
|
||||
@@ -251,7 +254,7 @@ If any of these come back empty, re-run `bunx omo install --platform=codex` —
|
||||
|
||||
#### Codex CLI
|
||||
|
||||
Codex uses its own OpenAI authentication. The omo-codex adapter inherits whatever auth Codex CLI is already using — there is nothing extra to configure here. If `codex --help` works for you, you are done with Codex auth.
|
||||
Codex uses its own OpenAI authentication. The Light edition inherits whatever auth Codex CLI is already using. There is nothing extra to configure here. If `codex --help` works for you, you are done with Codex auth.
|
||||
|
||||
#### OpenCode providers
|
||||
|
||||
@@ -544,7 +547,7 @@ Skip this section if `--platform=opencode`. Otherwise, the user installed the **
|
||||
|
||||
- **Plugin cache:** `~/.codex/plugins/cache/sisyphuslabs/omo/<version>/`
|
||||
- **Component binaries:** `~/.local/bin/omo-rules`, `omo-comment-checker`, `omo-lsp`, `omo-ultrawork`, `omo-ultragoal` (or `$CODEX_LOCAL_BIN_DIR/omo-*` if set)
|
||||
- **Codex config edits:** `~/.codex/config.toml` gained `[features] plugins = true`, `[features] plugin_hooks = true`, a `[plugins."omo@sisyphuslabs"]` block, and SHA256-pinned `[hooks.state."omo@..."]` entries
|
||||
- **Codex config edits:** `~/.codex/config.toml` gained `[features] plugins = true`, `[features] plugin_hooks = true`, `[marketplaces.sisyphuslabs]` pointing at `https://github.com/code-yeongyu/lazycodex.git`, `[plugins."omo@sisyphuslabs"]`, and SHA256-pinned `[hooks.state."omo@sisyphuslabs:..."]` entries
|
||||
|
||||
#### The 5 components
|
||||
|
||||
@@ -558,7 +561,7 @@ Skip this section if `--platform=opencode`. Otherwise, the user installed the **
|
||||
|
||||
#### Coexistence with OpenCode
|
||||
|
||||
The Codex adapter is fully independent of the OpenCode plugin. You can install both side-by-side — they share no runtime state, no config files, and no model selection. Each emits its own daily telemetry event.
|
||||
The Codex CLI Light edition is fully independent of the OpenCode plugin. You can install both side-by-side. They share no runtime state, no config files, and no model selection. Each emits its own daily telemetry event.
|
||||
|
||||
#### Codex troubleshooting
|
||||
|
||||
@@ -567,7 +570,7 @@ The Codex adapter is fully independent of the OpenCode plugin. You can install b
|
||||
| `codex --help` does not list the omo plugin | Re-run `bunx omo install --platform=codex` (idempotent — hook hashes are recomputed) |
|
||||
| `command not found: omo-rules` | Add `~/.local/bin` to `PATH`, or set `$CODEX_LOCAL_BIN_DIR` to a directory already on `PATH` |
|
||||
| `npm install` fails mid-install | `rm -rf ~/.codex/plugins/cache/sisyphuslabs` and retry |
|
||||
| Plugin block is present but hooks do not fire | Verify `~/.codex/config.toml` contains `[features]\nplugins = true\nplugin_hooks = true` |
|
||||
| Plugin block is present but hooks do not fire | Verify `~/.codex/config.toml` contains `[features]\nplugins = true\nplugin_hooks = true` and `[plugins."omo@sisyphuslabs"]` |
|
||||
| Hook trust hash mismatch warnings | Re-run the installer; hashes are regenerated each install |
|
||||
|
||||
### Step 8: Team Mode (optional, opt-in)
|
||||
@@ -661,7 +664,7 @@ Every agent, hook, skill, MCP, command, and tool is configurable via `disabled_*
|
||||
| `OMO_INVOCATION_NAME` | Overrides detected bin name (`oh-my-opencode`, `omo`, `lazycodex`, etc.). Used to route `lazycodex install` to `--platform=codex`. |
|
||||
| `OMO_DISABLE_POSTHOG=1` | Disables all PostHog telemetry for the main plugin |
|
||||
| `OMO_SEND_ANONYMOUS_TELEMETRY=0` | Same effect as above |
|
||||
| `OMO_CODEX_DISABLE_POSTHOG=1` | Disables PostHog telemetry for the Codex adapter only |
|
||||
| `OMO_CODEX_DISABLE_POSTHOG=1` | Disables PostHog telemetry for the Codex CLI Light edition only |
|
||||
| `OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0` | Same effect as above |
|
||||
| `OMO_DISABLE_PROCESS_CLEANUP=1` | Disables background-agent best-effort process cleanup on parent exit |
|
||||
| `OMO_OPENCLAW_COMMAND_TIMEOUT_MS` | Timeout for OpenClaw outbound shell/HTTP commands |
|
||||
@@ -709,7 +712,7 @@ Per product:
|
||||
| Product | Event name | Sources |
|
||||
|---------|-----------|---------|
|
||||
| Main plugin | `oh_my_openagent_daily_active` | Session start |
|
||||
| Codex adapter | `omo_codex_daily_active` | Installer (`install_completed`) + Codex `SessionStart` hook (`session_start`) |
|
||||
| Codex CLI Light edition | `omo_codex_daily_active` | Installer (`install_completed`) + Codex `SessionStart` hook (`session_start`) |
|
||||
|
||||
Opt-out:
|
||||
|
||||
@@ -719,13 +722,13 @@ export OMO_DISABLE_POSTHOG=1
|
||||
# or
|
||||
export OMO_SEND_ANONYMOUS_TELEMETRY=0
|
||||
|
||||
# Disable only the Codex adapter's telemetry
|
||||
# Disable only the Codex CLI Light edition telemetry
|
||||
export OMO_CODEX_DISABLE_POSTHOG=1
|
||||
# or
|
||||
export OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0
|
||||
```
|
||||
|
||||
The global flags (`OMO_DISABLE_POSTHOG`, `OMO_SEND_ANONYMOUS_TELEMETRY`) also suppress the Codex adapter's telemetry.
|
||||
The global flags (`OMO_DISABLE_POSTHOG`, `OMO_SEND_ANONYMOUS_TELEMETRY`) also suppress the Codex CLI Light edition telemetry.
|
||||
|
||||
See [Privacy Policy](../legal/privacy-policy.md) and [Terms of Service](../legal/terms-of-service.md).
|
||||
|
||||
@@ -752,13 +755,14 @@ opencode --version
|
||||
# Plugin should no longer be loaded
|
||||
```
|
||||
|
||||
### Remove the Codex adapter
|
||||
### Remove the Codex CLI Light edition
|
||||
|
||||
```bash
|
||||
# 1. Remove the plugin cache
|
||||
rm -rf ~/.codex/plugins/cache/sisyphuslabs
|
||||
|
||||
# 2. Edit ~/.codex/config.toml and remove these blocks:
|
||||
# [marketplaces.sisyphuslabs]
|
||||
# [plugins."omo@sisyphuslabs"]
|
||||
# [hooks.state."omo@sisyphuslabs"]
|
||||
|
||||
|
||||
@@ -68,7 +68,9 @@ bunx oh-my-openagent install
|
||||
| `--vercel-ai-gateway <value>` | Vercel AI Gateway: `no`, `yes` (Ultimate only) |
|
||||
| `--skip-auth` | Skip authentication setup hints |
|
||||
|
||||
When using the `lazycodex` bin alias, `install` defaults to `--platform=codex`. Subscription flags (`--claude`, `--openai`, etc.) only apply when `--platform` is `opencode` or `both` — they are rejected under `--platform=codex` because the Light edition does not write OpenCode model config.
|
||||
When using the `lazycodex` bin alias, `install` defaults to `--platform=codex`. `lazycodex` is only the npm/bin alias and marketplace repository name. The Codex config uses marketplace `sisyphuslabs` and plugin `omo`, enabled as `omo@sisyphuslabs`, with the marketplace source set to `https://github.com/code-yeongyu/lazycodex.git`.
|
||||
|
||||
Subscription flags (`--claude`, `--openai`, etc.) only apply when `--platform` is `opencode` or `both`. They are rejected under `--platform=codex` because the Light edition does not write OpenCode model config.
|
||||
|
||||
### Telemetry and opt-out
|
||||
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Reserving the lazycodex npm name (first-publish playbook)
|
||||
|
||||
`lazycodex` is the npm/bin alias for the Codex CLI Light edition and the Git repository that hosts the native Codex marketplace bundle. It is not the marketplace identity. Codex installs marketplace `sisyphuslabs` and plugin `omo`, enabled as `omo@sisyphuslabs`.
|
||||
|
||||
The `publish.yml` workflow includes `lazycodex` in trusted-publisher preflight, but that check is soft for first publish.
|
||||
If `lazycodex` is not yet claimed on npm, the workflow warns and continues so existing package releases are not blocked.
|
||||
To claim the name, run a one-time manual `npm publish` for `lazycodex` from a trusted environment (for example local shell with `NPM_AUTH_TOKEN`).
|
||||
@@ -7,3 +9,5 @@ After the first manual publish, configure GitHub Actions trusted publishing at:
|
||||
https://www.npmjs.com/package/lazycodex/access
|
||||
Set Provider to GitHub Actions, Organization to `code-yeongyu`, Repository to `oh-my-openagent`, and Workflow filename to `publish.yml`.
|
||||
After this setup, subsequent releases from `publish.yml` can publish `lazycodex` automatically.
|
||||
|
||||
The same release workflow also syncs `packages/omo-codex/marketplace.json` and `packages/omo-codex/plugin/` into `code-yeongyu/lazycodex` as `.agents/plugins/marketplace.json` and `plugins/omo/`. That cross-repo push requires the `LAZYCODEX_SYNC_TOKEN` repository secret.
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
Comparison and porting record for the three rule injection implementations
|
||||
maintained out of `/Users/yeongyu/local-workspaces`:
|
||||
|
||||
- **codex-rules** — Codex hook plugin (`codex-plugins/plugins/codex-rules`, repo `code-yeongyu/codex-rules`, branch `main`).
|
||||
- **codex-rules** — Codex hook plugin now bundled under the OMO Codex marketplace plugin (`packages/omo-codex/plugin/components/rules`, marketplace `sisyphuslabs`, plugin `omo`). The original standalone repo was `code-yeongyu/codex-rules`, branch `main`.
|
||||
- **pi-rules** — pi-mono extension (`pi-extensions/pi-rules`, repo `code-yeongyu/pi-rules`, branch `main`).
|
||||
- **omo rules-injector** — opencode plugin path (`omo/src/hooks/rules-injector`, repo `code-yeongyu/oh-my-openagent`, branch `dev`).
|
||||
|
||||
@@ -18,7 +18,7 @@ maintained out of `/Users/yeongyu/local-workspaces`:
|
||||
Installation state after the porting round:
|
||||
|
||||
- **omo** — `~/.bun/install/global/node_modules/oh-my-opencode` is a symlink to the local workspace, so `bun run build` immediately publishes the rebuilt `dist/`. Verified via `grep -c transcriptHydration dist/index.js` → 6.
|
||||
- **codex-rules** — `node scripts/install-local.mjs ...` was rerun and the cache at `~/.codex/plugins/cache/code-yeongyu-codex-plugins/codex-rules/0.1.0` was refreshed.
|
||||
- **codex-rules** — now installed through the aggregate OMO Codex plugin cache at `~/.codex/plugins/cache/sisyphuslabs/omo/<version>/components/rules`, enabled by `[plugins."omo@sisyphuslabs"]`.
|
||||
- **pi-rules** — pi-mono consumes the package source directly; no separate install step.
|
||||
|
||||
## 1. Performance baseline
|
||||
|
||||
@@ -10,7 +10,7 @@ Codex harness adapter for **oh-my-openagent**. Brings the OMO experience (rules
|
||||
| `marketplace.json` | Codex marketplace manifest. Identifies `omo` as the single installable plugin. |
|
||||
| `scripts/` | Node ESM build scripts for Codex cache installation and marketplace config updates. |
|
||||
| `src/` | TypeScript runtime: installer + telemetry consumed by the omodex CLI. |
|
||||
| `MARKETPLACE.md` | Vendored upstream marketplace README. |
|
||||
| `MARKETPLACE.md` | Native Codex marketplace notes for `sisyphuslabs` / `omo`. |
|
||||
|
||||
## Components Vendored
|
||||
|
||||
@@ -35,7 +35,7 @@ bunx oh-my-openagent install --platform=codex
|
||||
|
||||
To install **both** the Ultimate edition (OpenCode plugin) and the Light edition (this package) at once, use `--platform=both`.
|
||||
|
||||
The installer copies the built plugin into `~/.codex/plugins/cache/sisyphuslabs/omo/<version>/`, enables `omo@sisyphuslabs` in `~/.codex/config.toml`, and registers the `sisyphuslabs` marketplace from the `lazycodex` Git repository for native Codex marketplace upgrades.
|
||||
The installer copies the built plugin into `~/.codex/plugins/cache/sisyphuslabs/omo/<version>/`, enables `omo@sisyphuslabs` in `~/.codex/config.toml`, and registers the `sisyphuslabs` marketplace from the `lazycodex` Git repository for native Codex marketplace upgrades. `lazycodex` is the repo/npm/bin alias; the marketplace identity remains `sisyphuslabs`.
|
||||
|
||||
To install both editions in one command, use `--platform=both`.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user