Storage
Where the AgentOnboard CLI keeps your keys and configuration — ~/.agentonboard and how to reset it
Storage
The aon CLI keeps all of its state in a single directory in your home folder: ~/.agentonboard/. Everything is per-machine and per-user.
Layout
~/.agentonboard/
└── (files the CLI creates for you)Two things live here:
config.json— your configuration (theapiUrlvalue, when you have set one)tokens.json— your saved API keys
Both files are created automatically the first time you save a key or set a config value — you never create them by hand.
Treat your keys like a credential
The saved keys file holds your raw static API keys in plaintext. Never commit it to source control or share it.
Debugging
- A file is missing — the CLI treats it as empty and keeps working. Just re-run
aon saveoraon config setto recreate it. - A file is corrupt —
aon doctorreports the problem. Back up the file if it matters, then delete or repair it. - The config points at the wrong API — run
aon config set apiUrl <url>to point elsewhere, oraon config reset apiUrlto go back to the default.
Reset
To start completely fresh:
rm -rf ~/.agentonboardThis deletes your saved keys and configuration. Regenerate any key you need from your dashboard, then aon save it again.
You can always regenerate a key
Deleting ~/.agentonboard only removes what the CLI stored locally. Your account and API keys are safe on the AgentOnboard dashboard — re-save with aon save whenever you need them.
Related
aon save— add a key to local storageaon config— manage local configurationaon doctor— validate local storage