Docs ยท Start here
Install.
The remoco CLI is a typed Node.js command client distributed as an npm package. It runs on macOS and Linux; Windows works via WSL.
Prerequisites
- Node.js 20 or newer.
gcloudCLI (bundled in the workstation image; install on your Mac only if you want to SSH without theremocohelper).- A verified WorkOS AuthKit identity with a current Remoco Organization membership.
Install globally
$ npm install -g @doss-labs/remoco $ remoco --version 0.3.0
Authenticate
$ remoco login # WorkOS device confirmation with a manual-code fallback # persists only the Remoco PAK at ~/.remoco/credentials.json
Environment (optional overrides)
| Variable | Default |
|---|---|
REMOCO_ENV | staging; select staging or prod |
REMOCO_API_URL | https://api.remoco.dev; staging API override |
REMOCO_API_URL_PROD | https://api.remoco.dev; production API override |
REMOCO_API_TOKEN | unset; read by remoco login as an explicit non-interactive bearer |
The alpha package is scoped as
@doss-labs/remoco. It is pre-release, so command contracts may still change before v1.