> ## 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

> Run your Agentcard organization from the terminal: credentials, test balance, webhooks, and the integration wizard.

Everything you can do in the dashboard, you can do from the terminal. The same CLI your users run has a `companies` namespace for organizations.

## Installation

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

Update any time with `agent-cards update`.

## Authentication

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

A sign-in link and short code appear, and you approve in your browser. Then pick the organization you work in:

```bash theme={null}
agent-cards companies list
agent-cards companies use ORG_ID
```

For scripts and CI, `agent-cards login --email you@example.com` sends a one-time code, and adding `--code 123456` completes it without a browser.

## Commands

All of these live under `agent-cards companies`:

| Command                                                | What it does                                                                  |
| ------------------------------------------------------ | ----------------------------------------------------------------------------- |
| `create` / `list` / `get` / `use`                      | Create an organization, list yours, pick the active one                       |
| `wizard`                                               | The integration agent: implements Agentcard in your codebase and reports back |
| `credentials create` / `list` / `revoke`               | Manage the OAuth clients behind your `client_id` and `client_secret`          |
| `env test` / `env production`                          | Point the CLI at sandbox or production credentials                            |
| `balance get` / `provision` / `transfers` / `settings` | See and manage the company balance                                            |
| `balance test-fund`                                    | Add sandbox balance so you can test issuing end to end                        |
| `balance withdraw`                                     | Withdraw from the company balance                                             |
| `webhooks list` / `create` / `update` / `delete`       | Manage webhook endpoints                                                      |
| `webhooks reveal` / `roll-secret`                      | Read or rotate an endpoint's signing secret                                   |
| `webhooks deliveries` / `test`                         | See recent deliveries, or send a test event                                   |
| `members`                                              | Manage who is in the organization                                             |
| `subscribe`                                            | Start the subscription that unlocks production                                |
| `return-urls`                                          | Set where hosted flows send users back to                                     |

Use `--help` on any of them for flags:

```bash theme={null}
agent-cards companies webhooks test --help
```

## Good to know

* Sandbox or production follows the credentials you're using, the same rule as the API.
* `webhooks test` is the fastest way to check your endpoint verifies signatures correctly before going live.
* The wizard reads these docs as its source. If you'd rather integrate by hand, nothing here is required: the [Quickstart](/get-started/quickstart) uses plain curl.

Next: [Test in sandbox](/ship/test-in-sandbox)