opencode-cloud Node.js CLI

Cross-platform CLI for opencode-cloud with prebuilt binaries for major platforms.

Installation

npx opencode-cloud@latest --version

bunx opencode-cloud@latest --version

npm install -g opencode-cloud

No Rust toolchain required — npm automatically downloads the correct binary for your platform.

Supported Platforms

| Platform | Architecture | Package | |----------|--------------|---------| | macOS | Apple Silicon (arm64) | @opencode-cloud/cli-node-darwin-arm64 | | macOS | Intel (x64) | @opencode-cloud/cli-node-darwin-x64 | | Linux | x64 (glibc) | @opencode-cloud/cli-node-linux-x64 | | Linux | ARM64 (glibc) | @opencode-cloud/cli-node-linux-arm64 | | Linux | x64 (musl/Alpine) | @opencode-cloud/cli-node-linux-x64-musl | | Linux | ARM64 (musl/Alpine) | @opencode-cloud/cli-node-linux-arm64-musl |

Windows support planned for a future release.

How it works

1. When you install opencode-cloud, npm downloads a platform-specific package based on your OS and architecture
2. The main package finds the binary from the platform package
3. All CLI invocations spawn the Rust binary with transparent passthrough (stdio: inherit)
4. Exit codes, colors, and TTY detection are preserved

Development

When developing locally, place the Rust binary in the Node package bin/ directory:

cargo build --release
cp target/release/occ packages/cli-node/bin/

Then run via just run or node packages/cli-node/dist/index.js <args>. The wrapper resolves the binary from bin/ when platform packages are not used.

Usage

occ start
occ status
occ stop

All commands are identical between the npm and cargo installations.

License

MIT