Installation

Install the CLI

The quickest path on macOS and Linux:

curl -fsSL https://raw.githubusercontent.com/jtljrdn/handoff-env/main/install.sh | sh

The installer drops a compiled binary into ~/.local/bin (override with HANDOFF_INSTALL_DIR). Add that directory to your PATH if it isn't already.

On Windows, install via npm:

npx handoff-env --help

Verify the install:

handoff --help

Sign in

handoff login

This opens your browser, authenticates you against your Handoff account, and stores a token at ~/.config/handoff/auth.json. To skip the browser (handy on a headless box), pass a token directly:

handoff login --token hnd_xxxxxxxx

Next up

With the CLI installed and authenticated, you're ready to push your first project.