@codex-z/cli
v0.3.2
Published
Run Pi and Claude Code as first-class external harnesses inside Codex Desktop.
Maintainers
Readme
@codex-z/cli
Run Pi and Claude Code as first-class external harnesses inside Codex Desktop.
Install
npm install -g @codex-z/[email protected]npm automatically installs the matching macOS, Windows, or Linux platform package. Node.js 22 or 24 and the official ChatGPT/Codex Desktop are required.
Usage
codex-z --version
codex-z
codex-z remote install
codex-z remote statusThe codex-z command starts Codex Desktop. On macOS and Linux it returns immediately while the packaged Launcher keeps supervising in the background. On Windows, the command remains attached until Codex Desktop exits so shells that clean up process trees of completed commands cannot discard the supervisor. Re-running codex-z attaches to the same controlled instance.
On macOS, remote install installs a current-user Aqua Harness broker so Background SSH Hosts can use native Claude Code login without reading, copying, or unlocking Keychain credentials.
If installation used --omit=optional, reinstall without that option so npm can select the native package for the current architecture.
If startup reports a platform package version mismatch, close Codex Desktop and run the exact reinstall command in the error. This installs both the CLI and its platform package at the same version, replacing stale independently installed payloads. codex-z --version reports the CLI package version; startup also validates the platform payload before launching it.
