Skip to content

Install and sign in

Install the Hooksmith CLI with any package manager, then sign in. The CLI uses a browser device code by default. Personal tokens cover CI, servers and agents.

Install

Any package manager works. The CLI itself runs on bun; the curl installer sets that up for you.

curl -fsSL https://hooksmith.tech/install.sh | bash

Installs bun first if it's missing, then the CLI from Buildkite Packages.

Connect your account

Run hooksmith login with no flags. The CLI prints a short code and opens hooksmith.tech/device. Sign in there, confirm the code matches your terminal, and approve. The code expires after 10 minutes. The CLI then stores a personal token in ~/.hooksmith/credentials.json, readable only by you.

Over SSH or in a container, add --no-browser to print the code and URL without opening a browser. Email and password still work with --email, adding --register the first time.

For CI, servers and agents, create a token in Settings and log in with --token, so the machine never sees your password. hooksmith logout removes the token from the machine; it does not revoke it.

terminal
hooksmith login                       # approve the code in your browser
hooksmith login --no-browser          # over SSH: print the code and URL only
hooksmith login --email you@domain --password '...'   # add --register the first time
# or, with a token from Settings:
hooksmith login --token hkpat_...
hooksmith whoami