repome

Getting started

Install the CLI, sign in, and create your first repo.

This walkthrough takes about three minutes. You'll install the repome CLI, sign in via your browser, and create an empty repo.

Install the CLI

npm i -g @repome/cli

Verify the install:

repome --version

Sign in

repome init runs the device-flow login. There is nothing to configure: an organization is created automatically when you sign up, with an opaque server-minted slug and a name derived from your display name or email (renamable later). Re-running init is idempotent — it surfaces current state without re-prompting.

repome init

The CLI prints a URL — open it in a browser, approve the request, and the CLI receives a long-lived API key automatically.

Credentials live in ~/.config/repome/auth.json with mode 0600. The stored key is an rpme_… API key. REPOME_API_KEY overrides the file for CI, agents, and scripts.

If you only want to (re-)authenticate, use repome auth login.

Create a repository

repos create takes a bare name; the repo is created in your active org.

repome repos create hello-world

Clone it

repome git clone resolves the storage remote, mints a short-lived read token, and runs git clone with the credential helper wired up.

repome git clone hello-world

Prefer to drive git yourself? repome repos get hello-world prints the storage remote URL.

Where to next

On this page