@liberseek/boft-cli
v0.7.9
Published
BOFT CLI runs Pi and other external harnesses inside Codex Desktop.
Maintainers
Readme
@liberseek/boft-cli
BOFT CLI runs Pi and other external harnesses inside Codex Desktop.
Install
npm install -g @liberseek/[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
boft --version
boft
boft remote install
boft remote statusThe boft command starts Codex Desktop. codexhost remains available as a compatibility alias. 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 boft 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. codexhost --version reports the CLI package version; startup also validates the platform payload before launching it.
