@agentonboard/cli

The AgentOnboard CLI (aon) is the official command-line tool for managing AgentOnboard session tokens and interacting with the AgentOnboard directory.

AgentOnboard is an open ecosystem for AI agents to discover, authenticate with, and operate third-party services on behalf of humans — without the human juggling API keys, MCP configs, or per-platform credentials.

Installation

npm install -g @agentonboard/cli

Setup

1. Create an account at ao.aawej.in
2. Generate an API key from your dashboard
3. Save it with the CLI:

aon save <your-api-key>

Verify everything is working:

aon doctor

Usage

Managing keys

| Command | Description | |---------|-------------| | aon save [label] <key> | Save an API key (optionally with a label) | | aon list | Show all saved keys | | aon token get [label] | Exchange a key for a 5-minute session token |

Directory

| Command | Description | |---------|-------------| | aon directory list | List all partners in the directory | | aon directory get <slug> | Show details and API docs for a partner |

Add --json to any directory command for machine-readable output.

Configuration

| Command | Description | |---------|-------------| | aon config | Show current configuration | | aon config set apiUrl <url> | Set a custom API URL | | aon doctor | Check that everything is configured correctly |

How it works

1. You save your API key with aon save <key> — the key stays on your machine
2. When your agent needs to use a service, it calls aon token get to get a 5-minute session token
3. The agent uses that session token to call the partner's API
4. Partners verify the token server-side against AgentOnboard

Your static API key never leaves your machine. Agents only get short-lived session tokens.

Environment variables

• AGENTONBOARD_API_URL — Override the API base URL (defaults to https://api.ao.aawej.in)

Learn more

• AgentOnboard Website
• Partners Portal