omo-ai beta migration can select a cached or higher-priority legacy omo

[eddieparc]

Summary

Users installing the senpi-based omo-ai@beta can still execute a cached legacy omo wrapper in the same zsh session. The installation succeeds, but omo shows the legacy oh-my-opencode command help instead of launching the bundled senpi CLI.

Primary packaging issue: code-yeongyu/oh-my-openagent#6686

Reproduction

1. Have ~/.local/bin/omo from legacy OMO and invoke it once in zsh.
2. Keep the npm global bin directory earlier in PATH.
3. Run npm i -g omo-ai@beta.
4. Run omo in the same zsh session.

Observed:

cached=/Users/jgp/.local/bin/omo
omo --version => 4.19.4
Usage: oh-my-opencode [options] [command]

After rehash:

omo --version => 2026.8.9-2

The latter is the expected bundled @code-yeongyu/senpi version, confirming that the senpi package itself is installed and runnable.

Impact

Migration users may conclude that senpi/omo-ai was not installed, reinstall repeatedly, or report a false binary/package conflict. which -a omo can show the npm binary first while zsh still executes its cached path, making diagnosis non-obvious.

Workaround

rehash
# or
hash -r

Opening a new shell also clears the stale command resolution.

Requested coordination

Please keep this issue as the senpi-side consumer report and cross-reference the packaging fix in code-yeongyu/oh-my-openagent. The actionable launcher/install changes belong to that repository; no senpi core behavior change has been identified.

Environment: macOS Darwin 25.5.0 arm64, zsh, Node.js 24.14.0, omo-ai@5.0.0-0.beta.3. Internal tracking: LAB-39.

[eddieparc]

Manual QA update: there are two independent shell-resolution cases, not only command hashing.

• hash -r/rehash fixes a stale command cache when the npm global bin is already earlier in PATH.
• It does not fix PATH order when ~/.local/bin is earlier than the npm prefix.

Verified recovery for both cases:

export PATH="$(npm prefix -g)/bin:$PATH"
hash -r
command -v omo
omo --version

Observed transition: legacy 4.19.4 -> omo-ai beta 5.0.0-0.beta.3 with bundled senpi 2026.8.9-2. The refreshed CLI also passes --help; an unknown option exits 1. The proposed docs PR will use this robust sequence.

[eddieparc]

Documentation fix PR in the package owner repository: code-yeongyu/oh-my-openagent#6687