aon save
Save an API key with the AgentOnboard CLI — signature, labelling, and where the key is written
aon save
Save an AgentOnboard API key to your machine so the CLI can exchange it for session tokens later.
Usage
aon save [label] <key>The key is required. The label is optional.
aon save:
- Stores the key on your machine in
~/.agentonboard/ - Auto-labels the key
Key #Nwhen no label is given - Prints the location it saved to on success
Examples
Save a key without a label (auto-labelled Key #1):
aon save aon_test_key_123Save a key with a label:
aon save production aon_test_key_456A key is required
Running aon save without a key shows a usage message and exits without saving.
Labelling
By default the CLI labels your key Key #N, starting at Key #1. Labels matter because aon token get and aon list refer to keys by label — give your keys a name you will remember if you save more than one.
Where the key is written
Keys are stored in your home folder under ~/.agentonboard/. The directory is created automatically if it does not exist.
Keep your key private
Your raw static API key is stored in plaintext on your machine. Treat it like a credential — never commit it to source control.
Related
aon list— show which keys you have savedaon token get— exchange the saved key for a session tokenaon doctor— verify your setup