Installation
The CLI is a Go binary built from the endgame-cli repository. You’ll need Go installed./usr/local/bin (or ~/.local/bin if that isn’t writable). You can also pass a custom install directory: ./install.sh ~/bin.
Verify the install:
Authentication
Authenticate with your Endgame account via OAuth:- Browser login — opens a browser on this machine and completes the OAuth flow on a localhost callback
- Device-code login — displays a code you enter in a browser on any device, for remote servers or separate browser sessions
If the CLI is running on a remote server and you want to use browser mode,
forward the callback port first:
ssh -L 8788:127.0.0.1:8788 <server>, then
run endgame auth login --mode browser --callback-port 8788.~/.endgame-auth.json and refresh automatically — the CLI reuses the cached access token until it nears expiry, refreshes once before the request, and retries once on an authentication error. There are no auth environment variables to configure.
Running Tools
The CLI discovers the tools available to your account at login and caches them locally. See your tool set:--json or piped stdin:
The exact tool set is discovered from your account, so
endgame tools --help
always reflects what you can actually call. Refresh the cached tool list on
demand with endgame tools sync — the CLI also refreshes it automatically
after login and in the background when the cache is more than 12 hours old.