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

# bead account CLI commands

> Look up bead account CLI commands for signup, login, keys, balances, top-ups, billing, limits, and burst consent.

Look up bead account CLI commands for signup, account access and prepaid credit. [Global flags](https://docs.bead.run/cli/overview.md) apply throughout.

## Account access

| Command | Purpose |
| - | - |
| `bead signup [--agent]` | Create an agent account and retain private enrollment state. |
| `bead login` | Human device authorization. |
| `bead login --key-stdin` | Save a key read from stdin. |
| `bead account claim-link` | Create a private single-use ownership link, valid for 30 minutes; requires admin scope. |
| `bead api-key create NAME --preset ci [--ttl 90d]` | Create a CI preset key. TTL units are `s`, `h` or `d`. |

Save CI key output directly into your provider's secret store. Treat ownership links as credentials. Read [agent signup](https://docs.bead.run/agent-signup.md) before handing a claim link to a human.

## Balance, prices and limits

```bash theme={null}
bead balance
bead pricing
bead pricing --shape medium --hours 1 --disk-mib 1024 --machines 2
bead limits
bead burst true
bead burst false
```

`pricing` reads the live public schedule. Supply `--shape` and `--hours` together to estimate a bounded workload. Include all retained disk in `--disk-mib`. `limits` reads effective admission limits and usage. `burst` changes paid burst consent and requires admin scope.

## Add credit

```bash theme={null}
bead topup --amount "$TOPUP_CENTS" --purchase-file ./private-purchase.json --checkout
```

Set `TOPUP_CENTS` to your chosen purchase amount in whole cents in the billing currency. Keep purchase state private and reuse the file for recovery. The Checkout option returns a human payment handoff; payment settlement must complete before credit is funded. See [credit and payments](https://docs.bead.run/platform/top-up.md).

## Automatic refill

| Command | Purpose |
| - | - |
| `bead billing autorefill show` | Read current settings. |
| `bead billing autorefill set --enabled --threshold "$REFILL_THRESHOLD_CENTS" --amount "$REFILL_AMOUNT_CENTS" --monthly-cap "$REFILL_MONTHLY_CAP_CENTS"` | Enable refill with cent-denominated thresholds and cap. |
| `bead billing autorefill set` | Disable refill. |
| `bead billing autorefill save-card` | Open hosted card setup. |
| `bead billing autorefill recover` | Open payment recovery for a failed purchase. |

Set the refill variables to your chosen threshold, refill amount, and monthly cap in whole cents in the billing currency. Automatic refill controls require admin scope. Use returned payment URLs for human action and keep payment authorization material private.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.