AgentOnboard Docs
CLI Reference

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 (the apiUrl value, 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 save or aon config set to recreate it.
  • A file is corruptaon doctor reports 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, or aon config reset apiUrl to go back to the default.

Reset

To start completely fresh:

rm -rf ~/.agentonboard

This 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.

Next steps

On this page