diff --git a/docs/reference/cli.md b/docs/reference/cli.md index 481d28fad..65dbf1d97 100644 --- a/docs/reference/cli.md +++ b/docs/reference/cli.md @@ -7,6 +7,15 @@ Complete reference for the published CLI package. During the rename transition, Plugin registration inside `opencode.json` prefers `oh-my-openagent`. +## Bin Commands + +All published packages expose the same compiled CLI with these bin entries: + +- `oh-my-opencode` (legacy name, still primary) +- `oh-my-openagent` (renamed primary) +- `omo` (short alias, recommended in docs and prompts) +- `lazycodex` (Light edition shortcut; `lazycodex install` is equivalent to `omo install --platform=codex` unless `--platform` is explicitly overridden) + ## Basic Usage ```bash @@ -47,18 +56,35 @@ bunx oh-my-openagent install | Option | Description | | --- | --- | | `--no-tui` | Run in non-interactive mode (requires all needed options) | -| `--claude ` | Claude subscription: `no`, `yes`, `max20` | -| `--openai ` | OpenAI/ChatGPT subscription: `no`, `yes` | -| `--gemini ` | Gemini integration: `no`, `yes` | -| `--copilot ` | GitHub Copilot subscription: `no`, `yes` | -| `--opencode-zen ` | OpenCode Zen access: `no`, `yes` | -| `--zai-coding-plan ` | Z.ai Coding Plan subscription: `no`, `yes` | -| `--kimi-for-coding ` | Kimi For Coding subscription: `no`, `yes` | -| `--opencode-go ` | OpenCode Go subscription: `no`, `yes` | -| `--vercel-ai-gateway ` | Vercel AI Gateway: `no`, `yes` | +| `--platform ` | Install target edition: `opencode` (Ultimate, default), `codex` (Light), or `both` | +| `--claude ` | Claude subscription: `no`, `yes`, `max20` (Ultimate only) | +| `--openai ` | OpenAI/ChatGPT subscription: `no`, `yes` (Ultimate only) | +| `--gemini ` | Gemini integration: `no`, `yes` (Ultimate only) | +| `--copilot ` | GitHub Copilot subscription: `no`, `yes` (Ultimate only) | +| `--opencode-zen ` | OpenCode Zen access: `no`, `yes` (Ultimate only) | +| `--zai-coding-plan ` | Z.ai Coding Plan subscription: `no`, `yes` (Ultimate only) | +| `--kimi-for-coding ` | Kimi For Coding subscription: `no`, `yes` (Ultimate only) | +| `--opencode-go ` | OpenCode Go subscription: `no`, `yes` (Ultimate only) | +| `--vercel-ai-gateway ` | Vercel AI Gateway: `no`, `yes` (Ultimate only) | +| `--codex-autonomous` | Configure Codex with `approval_policy = "never"`, `sandbox_mode = "danger-full-access"`, and `network_access = "enabled"` when installing Light or Both | +| `--no-codex-autonomous` | Leave existing Codex permission settings unchanged when installing Light or Both | | `--skip-auth` | Skip authentication setup hints | -Anonymous telemetry uses PostHog with a hashed installation identifier. Disable with `OMO_SEND_ANONYMOUS_TELEMETRY=0` or `OMO_DISABLE_POSTHOG=1`. +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 the local built cache under `~/.codex/plugins/cache/sisyphuslabs`. + +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. `--codex-autonomous` and `--no-codex-autonomous` only affect installs where the selected platform includes Codex. + +### Telemetry and opt-out + +Anonymous telemetry uses PostHog with a hashed installation identifier. Two streams exist: + +- `omo_daily_active`: fired by the main plugin and `oh-my-openagent run`. +- `omo_codex_daily_active`: fired by `omo install --platform=codex` or `--platform=both` (`reason: "install_completed"`) and by the Codex plugin's `SessionStart` hook on every Codex session (`reason: "session_start"`). Both sources share the same UTC-day deduplication, so daily/weekly/monthly active counts reflect real Codex usage, not just install events. + +Opt-out env vars: + +- Global opt-out for oh-my-openagent and omo-codex: `OMO_SEND_ANONYMOUS_TELEMETRY=0` or `OMO_DISABLE_POSTHOG=1` +- Codex-only opt-out for `omo_codex_daily_active`: `OMO_CODEX_SEND_ANONYMOUS_TELEMETRY=0` or `OMO_CODEX_DISABLE_POSTHOG=1` --- diff --git a/docs/reference/configuration.md b/docs/reference/configuration.md index 424fb0e89..cc827a0cf 100644 --- a/docs/reference/configuration.md +++ b/docs/reference/configuration.md @@ -1007,6 +1007,8 @@ When enabled, OmO registers the hash-anchored `edit` tool and activates the `has | `OPENCODE_CONFIG_DIR` | Override OpenCode config directory (useful for profile isolation) | | `OMO_SEND_ANONYMOUS_TELEMETRY` | Set to `0`, `false`, or `no` to disable anonymous telemetry | | `OMO_DISABLE_POSTHOG` | Legacy telemetry opt-out flag. Set to `1` or `true` to disable PostHog | +| `OMO_CODEX_DISABLE_POSTHOG` | Set to `1` or `true` to disable PostHog telemetry for the `omo-codex` adapter only. Does not affect oh-my-opencode telemetry | +| `OMO_CODEX_SEND_ANONYMOUS_TELEMETRY` | Set to `0`, `false`, or `no` to disable anonymous telemetry for `omo-codex` only | | `POSTHOG_API_KEY` | Optional override for the built-in PostHog project API key | | `POSTHOG_HOST` | Override the PostHog ingestion host. Defaults to `https://us.i.posthog.com` | diff --git a/docs/reference/features.md b/docs/reference/features.md index 2bda8205f..3a8abce12 100644 --- a/docs/reference/features.md +++ b/docs/reference/features.md @@ -300,7 +300,7 @@ Skills provide specialized workflows with embedded MCP servers and detailed inst | **dev-browser** | Stateful browser scripting | Browser automation with persistent page state for iterative workflows and authenticated sessions. | | **frontend-ui-ux** | UI/UX tasks, styling | Designer-turned-developer persona. Crafts stunning UI/UX even without design mockups. Emphasizes bold aesthetic direction, distinctive typography, cohesive color palettes. | | **review-work** | "review work", "review my work", "QA my work" | Post-implementation review orchestrator. Launches 5 parallel background sub-agents for comprehensive review: goal verification, code quality, security, hands-on QA, and context mining. All must pass for review to pass. | -| **ai-slop-remover**| "remove AI slop", "de-AI", "humanize" | Removes AI-generated code smells from files while preserving functionality. Identifies and eliminates verbose comments, redundant error handling, over-engineered patterns, and generic AI phrasing. | +| **$omo:remove-ai-slops**| "remove AI slop", "de-AI", "humanize" | Removes AI-generated code smells from files while preserving functionality. Identifies and eliminates verbose comments, redundant error handling, over-engineered patterns, and generic AI phrasing. | #### git-master Core Principles diff --git a/docs/reference/rules-injection-cross-module-comparison.md b/docs/reference/rules-injection-cross-module-comparison.md index de5ee6851..f3b677914 100644 --- a/docs/reference/rules-injection-cross-module-comparison.md +++ b/docs/reference/rules-injection-cross-module-comparison.md @@ -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//components/rules`, enabled by `[plugins."omo@sisyphuslabs"]`. - **pi-rules** — pi-mono consumes the package source directly; no separate install step. ## 1. Performance baseline