Skip to content

Install the hadron CLI

hadron is the command-line interface to the Hadron platform — for humans working in a terminal and for AI agents shelling out to it. This guide gets it installed and authenticated. For the full command surface and output contract, see the hadron CLI reference.

Install

Homebrew (macOS)

brew tap hadron-memory/tap
brew install --cask hadron

Release archives (macOS, Linux, Windows)

Download the archive for your platform from the latest release, verify it against checksums.txt, and put the hadron binary on your PATH.

Go

go install github.com/hadron-memory/hadron-cli/cmd/hadron@latest

Note

go install builds without the release version stamp, so hadron version reports dev. Functionality is identical.

Sign in

Interactive (opens your browser for OAuth; the token is stored in your OS keychain):

hadron auth login
hadron auth whoami

For CI, scripts, and AI agents, use a personal access token instead — mint one in the portal (see Manage your API keys):

export HADRON_TOKEN=hdr_user_...      # env var, overrides stored tokens
# or store it once:
echo "$TOKEN" | hadron auth login --with-token

Verify

hadron auth status        # exit 0 = signed in
hadron memory ls --json   # list the memories you can see

The CLI talks to https://srv.hadronmemory.com by default. For a self-hosted server:

hadron config set server https://your-server.example.com

For AI agents

Two options once the binary is installed:

  • Tell the agent to run hadron agentic-usage — the CLI prints its own complete agent contract (stable exit codes, --json output rules, recipes).
  • In Claude Code, install the skill plugin:
/plugin marketplace add hadron-memory/hadron-cli
/plugin install hadron-cli@hadron

Next steps