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.
Docs pagesInstall and sign in
On this pageInstall
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.
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