> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Overview

> Manage your cards, balance, and shopping from the terminal

The `agent-cards` CLI is the terminal-first way to manage your personal Agentcard account — sign in, add cash to your balance, issue cards, and shop at linked merchants.

<Note>
  Personal commands are top level in the `agent-cards` CLI. Companies integrating Agentcard use the same CLI's `companies` namespace (`agent-cards companies …`), see the [Companies docs](/companies/introduction).
</Note>

## Installation

```bash theme={null}
npm install -g agent-cards
```

Update to the latest version any time:

```bash theme={null}
agent-cards update
```

If you've wired the CLI into a coding agent with [`agents add`](/personal/cli/api#teach-your-coding-agent), the installed steering blocks refresh themselves when the CLI updates.

## Authentication

Most commands require you to be signed in. Run `agent-cards signup` (or `login` — they're the same): a sign-in link and short code appear, and you approve in your browser (any device). On machines where the browser flow isn't available, we email you a one-time code instead. Credentials are stored locally; clear them with `agent-cards logout`.

## Command groups

| Group                                      | Description                                                                                                            |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| `signup` / `login` / `logout` / `whoami`   | [Account & session](/personal/cli/account)                                                                             |
| `wallet` / `balance` / `fund` / `withdraw` | [Wallet & balance](/personal/cli/wallet): see your cards and cash, add cash, withdraw                                  |
| `redeem` / `codes`                         | [Redeem a promo code](/personal/cli/wallet#redeem-a-promo-code) into your balance; list your codes                     |
| `cards`                                    | [Create, list, inspect, and close cards](/personal/cli/cards)                                                          |
| `attach`                                   | [Attach your own card](/personal/cli/cards#attach-your-own-card) so purchases charge it directly (also `cards attach`) |
| `transactions`                             | Per-card or account-wide [transaction history](/personal/cli/cards)                                                    |
| `kyc`                                      | Run one-time identity verification from the terminal ([KYC & approvals](/personal/kyc-and-approvals))                  |
| `account`                                  | Link another email or phone, or merge two accounts ([Linking accounts](/personal/linking-accounts))                    |
| `connections`                              | List or revoke third-party apps connected to your account                                                              |
| `approvals`                                | List, approve, or deny [requests from connected apps](/personal/kyc-and-approvals#approval-requests) waiting on you    |
| `rewards`                                  | Tokenback: view the token balance and redeem it ([Rewards](/personal/concepts/rewards))                                |
| `payment-method`                           | [Manage saved payment methods](/personal/cli/payment-methods)                                                          |
| `plan`                                     | [View and change your subscription](/personal/cli/plan)                                                                |
| `settings`                                 | [Notification and authorization preferences](/personal/cli/settings)                                                   |
| `buy`                                      | [Shop and check out at linked merchants](/personal/cli/buy)                                                            |
| `api`                                      | [The tool catalog for coding agents](/personal/cli/api): list, search, describe, and call every account tool           |
| `agents`                                   | [`agents add`](/personal/cli/api#teach-your-coding-agent) teaches Claude Code, Codex, or Gemini to drive Agentcard     |
| `setup-mcp`                                | Configure the Agentcard MCP server in Claude Code                                                                      |
| `update`                                   | Update the CLI in place                                                                                                |
| `support`                                  | Start a live support conversation                                                                                      |

## Global options

```
-V, --version      Show version number
-h, --help         Show help for any command
    --help --full  Every command, every group, one board
    --api-url <url>  API base URL for this invocation (same as AGENT_CARDS_API_URL)
```

Use `--help` on any subcommand for details:

```bash theme={null}
agent-cards cards create --help
```

## Agent-friendly flags

Several commands support non-interactive use so an agent can drive them without prompts:

* `cards create --amount <dollars> --yes` skips the confirmation prompt; add `--json` for machine-readable output.
* `cards close <id> --yes` skips the close confirmation.
* `attach --json` runs the attach flow non-interactively (a single request, no browser or polling).
* `buy checkout <merchant> --yes` confirms placing an order.
* The whole [`api` namespace](/personal/cli/api) is built for agents: JSON on stdout, `{error, hint}` envelopes on failure.