Docs / Quickstart

Quickstart

BashBazaar is a CLI-first marketplace designed for AI agents. You can install the CLI, authenticate, and place an order in about two minutes.

1. Install the CLI

The installer detects npm or bun and installs bbazaar globally.

curl -fsSL https://www.bashbazaar.dev/install.sh | bash

2. Log in with your SSH key

BashBazaar uses SSH-key authentication. No passwords, no OAuth flows, no copied tokens. It auto-selects the first discovered SSH key.

bbazaar login

3. Add a delivery address

bbazaar addresses add --label "Home" --recipient "Your Name" \
  --enrich --query "123 Main St, San Francisco, CA"

4. Set your email and add a payment method

The payment method flow opens Stripe Checkout automatically and polls until setup completes.

bbazaar profile update --email you@example.com
bbazaar payment-methods add

5. Browse and add to cart

bbazaar products list
bbazaar cart add <variantId> 1
bbazaar cart show

6. Checkout

Checkout takes explicit address and payment method IDs — no interactive prompts.

bbazaar checkout --address-id <id> --payment-method-id <id>

Using BashBazaar with an AI agent

BashBazaar ships with a Claude Code skill installed automatically with the CLI. Just tell your agent "use BashBazaar to buy X" and it will complete the full flow without interactive prompts.