@agentkeys-io/cli

The official CLI for AgentKeys — manage your AI credentials and agents from the terminal.

Installation

Global install (recommended):

npm install -g @agentkeys-io/cli

Without installing:

npx @agentkeys-io/cli <command>

Quick Start

1. Get an API key — Create an account at app.agentkeys.io, then go to Settings → API Keys to generate a key (ak_ws_...).

2. Set up the CLI:

   agentkeys init

   This saves your API key to ~/.agentkeys/config.json and verifies connectivity.

3. Check your workspace:

   agentkeys status

Commands

agentkeys init

Interactive setup wizard. Prompts for your API key and saves config.

agentkeys init

agentkeys login

Set or update your API key.

agentkeys login
# or non-interactively:
agentkeys login --key ak_ws_your_key_here

agentkeys status

Show workspace info: name, plan, credential count, agent count, monthly requests.

agentkeys status

agentkeys credentials

List credentials

agentkeys credentials list
# alias:
agentkeys creds ls

Displays a table: ID, Name, Type, Provider, Status, Last Used.

Add a credential (interactive)

agentkeys credentials add

Prompts for: name, type (API_KEY, OAUTH, SESSION, etc.), provider, value.

Remove a credential

agentkeys credentials remove <id>
# Skip confirmation:
agentkeys credentials remove <id> --yes

agentkeys agents

List agents

agentkeys agents list
# alias:
agentkeys agents ls

Create an agent (interactive)

agentkeys agents create

Prompts for: name, description.

Remove an agent

agentkeys agents remove <id>
# Skip confirmation:
agentkeys agents remove <id> --yes

agentkeys proxy <proxy-token> <url>

Make a test HTTP request through the AgentKeys proxy using a proxy token.

agentkeys proxy pt_abc123 https://api.resend.com/emails
# Show response body:
agentkeys proxy pt_abc123 https://api.resend.com/emails --body
# Use custom proxy base URL:
agentkeys proxy pt_abc123 https://api.resend.com/emails --proxy-url https://proxy.agentkeys.io

Config File

Stored at ~/.agentkeys/config.json:

{
  "apiKey": "ak_ws_...",
  "baseUrl": "https://app.agentkeys.io"
}

The file is created with 600 permissions (owner-read-only). The directory is 700.

API Reference

The CLI communicates with the AgentKeys REST API at https://app.agentkeys.io/api/v1/:

| Endpoint | Description | |---|---| | GET /api/v1/workspace/status | Workspace info + stats | | GET /api/v1/credentials | List credentials | | POST /api/v1/credentials | Create credential | | DELETE /api/v1/credentials/:id | Delete credential | | GET /api/v1/agents | List agents | | POST /api/v1/agents | Create agent | | DELETE /api/v1/agents/:id | Delete agent |

All requests use Authorization: Bearer <apiKey>.

Development

# Run from monorepo root:
npx tsx packages/cli/src/index.ts --help

# Build:
cd packages/cli && npm run build

# Run built version:
node packages/cli/dist/index.js --help

License

MIT — AgentKeys