bead account CLI commands - bead

Look up bead account CLI commands for signup, account access and prepaid credit. Global flags 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 before handing a claim link to a human.

Balance, prices and limits

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

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.

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.