Skip to main content

​
Prerequisites

Before you begin, you need:
  • An active HEVN account.
  • pipx (Python 3.11+) or Homebrew for an isolated end-user install.

​
Install

pipx installs the CLI from PyPI into its own isolated environment: 
pipx install hevn-cli
hevn --help
Upgrade to the latest published release: 
pipx upgrade hevn-cli

​
Homebrew

On macOS and Linux you can install from the HEVN tap: 
brew install hevn-inc/tap/hevn-cli
hevn --help
The tap is the formula source, so the first command both taps and installs. Upgrade with: 
brew upgrade hevn-cli

​
Authenticate

Run the browser login flow: 
hevn login
The CLI opens HEVN, waits for a local callback, saves your app API key, and prints the config path. If you are on a remote machine or do not want the browser to open automatically, use: 
hevn login --no-open
For automation or remote environments, save an API key directly without opening a browser: 
hevn login --api-key hvn_...
The same hvn_... key is used for all authenticated CLI calls, including transfers.

​
Confirm your account

Check the active account: 
hevn account get
Introspect the active API key, owning app, scopes, balance, and spend limit: 
hevn whoami
hevn whoami --yaml
List accounts in machine-readable form: 
hevn account list --yaml
Check transfer balance and allowance: 
hevn balance

​
First useful workflow

Create an email contact and transfer USDC: 
hevn contacts new --type email --name "Vendor" --email vendor@example.com
hevn contacts list --yaml
hevn transfer contact --contact-id <contact-id> --amount 25 --memo "Thanks"
Pay an invoice by id: 
hevn transfer --invoice-id <invoice-id> --memo "Invoice payment"

​
Log out

Clear saved local credentials: 
hevn logout
hevn logout removes saved HEVN CLI credential fields from the local config file. It does not delete your HEVN account or revoke unrelated credentials.