Configuration

The CLI is intentionally light on config. There's one file, a handful of env vars, and a few default paths.

Config file

Created by heroprompt login:

text

~/.heroprompt/config

Contains api_url and token. Plain JSON, readable and editable by hand if you need to.

Environment variables

Variable	Effect
`HEROPROMPT_API_URL`	Overrides the `api_url` from the config file
`HEROPROMPT_TOKEN`	Overrides the `token` from the config file (useful in CI)
`HEROPROMPT_CONFIG_DIR`	Move the config dir from `~/.heroprompt` to somewhere else

Env vars always win over the config file.

Default paths

Path	What lives there
`~/.heroprompt/config`	CLI config (token, api_url)
`~/.heroprompt/installed.json`	Local registry of installed packs + versions
`~/.heroprompt/prompts/`	Default output for `heroprompt sync`
`~/.claude/skills/heroprompt-*/`	Installed pack skills
`~/.claude/commands/heroprompt-*/`	Installed pack commands

Token management

Create and revoke tokens at /settings under CLI tokens. Limits per tier:

Tier	Active tokens
FREE	1
PRO	3
TEAM	10

Revoking a token in the dashboard invalidates it immediately on the server. The local config file still holds the old value — running heroprompt logout && heroprompt login --token <new> is the clean fix.