CLI

# hotcfg history

List an environment's versions with their author and hash, newest first.

usage

```
hotcfg history <bin_id> [--env <env>] [--limit <n>] [--json]
```

terminal

```
$ hotcfg history mobile-flags --env staging
VERSION       CREATED           AUTHOR                           HASH
v2 (current)  2026-11-05 23:09  GitHub Actions (sk_live_4f9a…)   7ac562a24ad0
v1            2026-11-05 23:09  Alex Kim                         1a4cdd68925a
```

Times are in your local time zone. An author is a person, or a key shown with its name and prefix.

## Flags

| Flag | Default | Description |
| --- | --- | --- |
| `--env` | `production` | The environment. |
| `--limit` | `20` | How many versions to show, at most 200. |
| `--json` |  | Print the API's JSON: `bin_id`, `environment`, `current_version` and `versions`. |

terminal

```
# The current version number, for a script
hotcfg history mobile-flags --env production --json | jq .current_version
```

Last updated 5 November 2026
