# ath key

> Manage a gateway key for predictions from the terminal.

Website: https://ath.fit/docs/key/
Markdown: https://ath.fit/docs/key.md

ATH v0.4.3 · MIT license. Documentation source: [cd89f72](https://github.com/mwhitham/ath/blob/cd89f72eceae3961ef1a05694226515c9e4321d2/src/program.ts). If your installed version differs, check its command help.

Checked 27 September 2026: v0.4.3 is available on npm.

## Usage

```text
ath key
```

## What it does

Shows which gateways are configured without printing their keys. An agent using its own model does not need an ATH gateway key.

## Examples

set prompts for a Vercel or OpenRouter key and stores it in the OS password store, never in the training record. ath key clear openrouter removes that saved key; ath key clear removes both saved gateway keys.

```text
ath key set openrouter
```

## ath key set

Accepts vercel or openrouter. Enter the key when prompted; do not put it in the command.

```text
ath key set openrouter
```

## ath key clear

Removes a saved gateway key. Omit the gateway to remove both saved keys.

```text
ath key clear openrouter
```

## Options

| Argument or option | Description |
| --- | --- |
| `--json` | structured output, for an agent rather than a person |

## Related commands

- [ath models](https://ath.fit/docs/models/)
- [ath predict](https://ath.fit/docs/predict/)