Remotemp CLI
The remotemp package installs licensed packs from the catalog with authenticated fetch — same entitlements as the web Library. npm package: remotemp@0.1.1+.
1. Install
# global (recommended) npm install -g remotemp # check version remotemp --version # one-shot without global install npx remotemp@latest --help
Requires Node.js 18+.
2. Auth (token)
- Sign in on the site (/sign-in).
- Open /cli/auth → Generate CLI token.
- Copy the
rmt_…token (valid ~7 days). - In the terminal:
remotemp login # paste token when prompted # or non-interactive: remotemp login --token rmt_…
Token is stored in ~/.config/remotemp/config.json. Do not commit or share it. Treat it like a password.
3. Doctor
Verify API reachability and account before installing packs:
remotemp doctor
Expect api_reachable and auth with your email. Failed auth → mint a new token and remotemp login again.
4. Add a pack
Use the slug from the listing page (also on catalog cards):
remotemp add otel-trace-map remotemp add billing-funnel --dir ./packages remotemp add auth-pkce-flow --name my-auth-pack --force # machine-readable (CI / scripts) remotemp add otel-trace-map --json cd otel-trace-map npm install npx remotion studio
| Flag | Meaning |
|---|---|
| --dir <path> | Parent folder (default: cwd) |
| --name <folder> | Output folder name (default: slug) |
| --force | Overwrite existing folder |
| --json | JSON success/error for scripts |
Commands
| Command | Description |
|---|---|
| login | Save rmt_ token |
| logout | Clear local token |
| whoami | Show email / Pro status |
| doctor | API + auth health check |
| add / install | Download + extract pack by slug |
| config | Show config path, API URL, token set |
Entitlements
- FREE — signed-in account only (CLI token from that account).
- PREMIUM — active Pro, or you own the listing, or a legacy purchase grant.
- Unpublished / draft packs cannot be installed by buyers.
Smoke free slugs (when marked FREE in catalog): otel-trace-map, billing-funnel, auth-pkce-flow.
Environment
| Variable | Default / notes |
|---|---|
| REMOTEMP_API_URL | https://remotemp.xyz — set for local API |
| REMOTEMP_TOKEN | Override saved token (CI). Prefer not to log this. |
REMOTEMP_API_URL=http://localhost:3000 remotemp doctor
How it works
- Browser session mints token via
POST /api/v1/cli/session - CLI stores token locally
GET /api/v1/cli/install/:slugchecks entitlement → short-lived ZIP URL → extract
Troubleshooting
401 / invalid token
Mint a new token at /cli/auth, then
remotemp login. Tokens expire after ~7 days.403 need Pro
Pack is PREMIUM. Get Pro at /pro (when checkout is live), or try a FREE slug first.
404 not found
Wrong slug or pack not published. Copy slug from the listing URL or page.
Folder exists
Use
--forceor--name other-folder.Cannot reach API
Check network / VPN. Override with
REMOTEMP_API_URL. Runremotemp doctor.
Also see buyer guide · FAQ.