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

# agent-cards buy

> Buy — chat to shop, or use a subcommand to link merchants, shop, and check out

Buy — chat to shop, or use a subcommand to link merchants, shop, and check out

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

```text theme={null}
Usage: agent-cards buy [options] [command]

Buy — chat to shop, or use a subcommand to link merchants, shop, and check out

Options:
  -h, --help                                                 display help for command

Commands:
  chat                                                       Chat in natural language to shop and check out
  merchants                                                  List merchants and link status
  link [options] <merchant>                                  Link a merchant account (rappi | goodeggs | doordash)
  confirm [options] <merchant>                               Confirm a merchant link with the one-time code
  unlink <merchant>                                          Disconnect a merchant (drops the saved session + link)
  connect <merchant>                                         Link a merchant by logging in via a hosted browser (doordash)
  stores <merchant> <query>                                  Find stores within a multi-store merchant (DoorDash) by name
  store <merchant> <storeId>                                 Scope searches + the cart to one store (DoorDash)
  search <merchant> <query>                                  Search a linked merchant for products
  cart <merchant>                                            View the cart
  add [options] <merchant> <productId>                       Add a product to the cart
  remove <merchant> <productId>                              Remove a product from the cart
  qty <merchant> <productId> <quantity>                      Set a product's quantity in the cart (0 removes it)
  clear <merchant>                                           Empty the cart
  budget [options] <period> <limitDollars>                   Set a spend budget (period: daily|weekly|monthly|total)
  checkout [options] <merchant>                              Place + pay for the cart (DESTRUCTIVE — requires --yes)
  orders [options] <merchant>                                View recent order history at a linked merchant
  reorder <merchant> <orderId>                               Re-create a cart from a past order (use the id from `buy orders`)
  track <merchant> <orderId>                                 Show status + ETA for a placed order (use the id from `buy orders`)
  substitution <merchant> <orderId> <itemMsid> <preference>  Set out-of-stock preference for an item (itemMsid = msid from `buy search`; preference = similar|refund|contact)
  addresses <merchant>                                       List the delivery addresses saved on a linked merchant account
  set-address <merchant> <addressId>                         Set the default delivery address (addressId = the id from `buy addresses`)
  help [command]                                             display help for command
```