Docs · CLI
CLI reference.
Every subcommand of the remoco binary. The CLI is a thin shell wrapper around the control-plane API at api.remoco.dev.
Workstation
| Command | Description |
|---|
remoco init | GitHub OAuth + provision your workstation. Stores token at ~/.remoco/api-token. |
remoco user add <name> <email> | Provision a workstation for a teammate (admin only, v0.1 placeholder until WorkOS lands). |
remoco user list | List workstations in the tenant. |
remoco user remove <name> | Delete a workstation instance (confirmation required). |
Dev loop
| Command | Description |
|---|
remoco dev [--service=X] | Start a service in a named tmux session. Survives idle-suspend transparently. |
remoco worktree <branch> | Create an isolated worktree + docker stack + alias + URL. |
remoco worktrees | List active worktrees with ports and URLs. |
remoco worktree --teardown <branch> | Tear down a worktree (stop containers, remove git worktree, drop alias). |
Publishing
| Command | Description |
|---|
remoco expose <alias> [--access=public|private] | Publish a stable URL. Default private (WorkOS gated). |
remoco hide <alias> | Remove the URL (ingress + DNS + Access app). |
remoco links | List currently-published URLs with access level. |
remoco share <port> | Ephemeral *.trycloudflare.com tunnel for a local port. |
remoco unshare <port> | Kill a share tunnel. |
Repos
| Command | Description |
|---|
remoco clone <owner/repo> [dir] | Git clone to ~/code + run skills-sync. |
remoco repos | List cloned repos. |
remoco resync | Re-run skills-sync to refresh agent skills. |
Artifacts + design systems
| Command | Description |
|---|
remoco artifact push <file> --title "..." [--tag a,b] [--customer slug] | Publish HTML (or any text) to gs://remoco-artifacts. Returns public URL + shortLink. |
remoco artifact list | List published artifacts. |
remoco ds push <folder> --slug <slug> | Publish a design system (tokens.css + primitives) for artifact generation. |
remoco ds fetch <slug> | Return the base URL for a DS. |
Diagnostics
| Command | Description |
|---|
remoco status | Dense one-shot overview: docker, tmux, portless, public links, share tunnels. |
remoco debugger start|stop|status | Manage the overlay/injector pair on :8081 and :9999. |
remoco reprovision | Clear the ~/.remoco/provisioned marker so startup hooks re-run. |
Environment
| Variable | Default | Meaning |
|---|
REMOCO_API | https://api.remoco.dev | Control-plane base URL |
REMOCO_API_TOKEN | — | Bearer token (or ~/.remoco/api-token) |
REMOCO_PROJECT | remoco-cloud | GCP project hosting the workstation |
REMOCO_DOMAIN | remoco.dev | Base domain for URL shape |
← Getting started
Skills reference →