CLI
CLI overview
Every command in the Handoff CLI, at a glance.
Commands
| Command | What it does |
|---|---|
handoff init | Create a new project and write .handoff/config.json |
handoff login | Authenticate this machine against your Handoff account |
handoff logout | Clear the stored credential |
handoff whoami | Show the user and organization the CLI is signed in as |
handoff push | Upload a local .env to a remote environment |
handoff pull | Download a remote environment to a local .env.<env> |
handoff diff | Compare your local .env to the remote version |
handoff run | Run a command with secrets injected as env vars |
Run any command with --help for its full flag list.
Where things live
| Path | Contents |
|---|---|
./.handoff/config.json | Project ID + default environment, committed with your repo |
~/.config/handoff/auth.json | Your login token (created by handoff login) |
Environment variables
| Variable | Used by | Purpose |
|---|---|---|
HANDOFF_TOKEN | run | Auth token, overrides auth.json (use in CI) |
HANDOFF_API_URL | all | Override the API base URL (local dev / self-host) |