Skip to main content
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.
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.

​
Installation

Update to the latest version any time:
If you’ve wired the CLI into a coding agent with agents add, 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

​
Global options

Use --help on any subcommand for details:

​
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 is built for agents: JSON on stdout, {error, hint} envelopes on failure.