Docs · Start here
Install.
The remoco CLI is a shell binary distributed as an npm package. It runs on macOS and Linux; Windows works via WSL.
Prerequisites
- Node.js 18+ (for the npm install); the CLI itself is shell, so node is only used to drop the binary in
PATH. gcloudCLI (bundled in the workstation image; install on your Mac only if you want to SSH without theremocohelper).- A GitHub account (OAuth provider).
Install globally
$ npm install -g @doss-labs/remoco $ remoco --version 0.1.0-alpha.0
Authenticate
$ remoco init # opens browser · GitHub OAuth · persists token at ~/.remoco/api-token
Environment (optional overrides)
| Variable | Default |
|---|---|
REMOCO_API | https://api.remoco.dev |
REMOCO_API_TOKEN | from ~/.remoco/api-token |
REMOCO_PROJECT | remoco-cloud |
REMOCO_DOMAIN | remoco.dev |
The package is
@doss-labs/remoco (private scope) while we're in pre-alpha. v0.3 will open-source the CLI under MIT.