The aggregate.plus toolbelt. Every command, one binary.

§1 · Install

One global install. One binary on $PATH.

The CLI ships as a single npm package with no native dependencies. Works on macOS, Linux, and Windows (WSL or PowerShell). Node 18+ is the only prerequisite.

npm install -g @aggregate-plus/cli

pnpm add -g @aggregate-plus/cli

bun add -g @aggregate-plus/cli

Verify the binary is on your $PATH:

$ aggregate-plus --version
@aggregate-plus/cli 1.0.0

§2 · Sign in

One paste. Permissioned for life.

The CLI authenticates with the same API keys the SDK uses. Issue a key at /developers/keys, then paste it into aggregate-plus auth login.

$ aggregate-plus auth login
? Paste your API key: ********************
Signed in as @alice (id: usr_2f4a…)
Saved to ~/.aggregate-plus/config.json (mode 0600)

$ aggregate-plus auth whoami
@alice · scopes: identity:read, posts:write, webhooks:write

$ aggregate-plus auth logout
Removed credentials from ~/.aggregate-plus/config.json

• Local-only storage, 0600 mode

  The key lives at ~/.aggregate-plus/config.json with mode 0600 (owner read/write only). Nothing is sent anywhere except the aggregate.plus API. Multiple environments? Override per-call with the AGG_API_KEY env var.

§3 · The first-dollar workflow

From sign-in to a hired creator — four commands.

A buyer signs in, finds a vetted UI/UX designer via the MCP server, inspects their tiers, and opens a hosted Stripe Checkout — without leaving the terminal.

# 1. Sign in (one-time)
$ aggregate-plus auth login
Signed in as @bryn (id: usr_9c1d…)

# 2. Find a vetted UI/UX designer — agent-style search
$ aggregate-plus mcp find "UI/UX designer for B2B SaaS"
Top matches:
  1. @alice    UI/UX · trust 92 · from $1,200
  2. @mateo    Product designer · trust 88 · from $950
  3. @priya    Brand + UI · trust 86 · from $1,400

# 3. Inspect the top match
$ aggregate-plus mcp creator alice
@alice — Senior UI/UX designer (San Francisco)
Trust score 92 · 47 verified reviews · 4.9 / 5
Offerings:
  prod_2f4a · Landing page redesign
    professional   $1,200   rush-3-day +$400
    business       $2,400   rush-3-day +$400 · figma-handoff +$300

# 4. Open a Stripe Checkout for the Professional tier + 3-day rush
$ aggregate-plus mcp create-order alice prod_2f4a \
    --tier professional --addons rush-3-day
Checkout ready — @alice · Landing page redesign · Professional + rush-3-day
  https://checkout.stripe.com/c/pay/cs_test_…
Open it in your browser to authorize the charge.

The CLI never sees card data — the printed URL is the hosted Stripe Checkout the buyer opens in their browser. Stripe authenticates, charges, and confirms; the order lands on /thanks/order with the verified-buyer review prompt ready.

§4 · Every command

Eleven commands. Four namespaces.

Every command accepts --json for machine-readable output and --help for a self-documenting man page.

§5 · JSON mode

Every command is jq-friendly.

Pass --json and the human table is swapped for the raw API response — same snake_case fields the REST surface returns. Pipe it into jq, fx, or your shell of choice.

# Top 5 design specialties by example skill count
$ aggregate-plus categories list --json \
    | jq -r '.[] | select(.slug == "design")
                 | .subcategories
                 | sort_by(-(.example_skills | length))[:5]
                 | .[].name'

# Average rating across @alice's last 50 reviews
$ aggregate-plus creators reviews alice --json \
    | jq '[.items[].rating] | add / length'

# Pipe MCP search into an order — no JS needed
$ TOP=$(aggregate-plus mcp find "brand strategist" --json \
        | jq -r '.matches[0].handle')
$ PROD=$(aggregate-plus mcp creator "$TOP" --json \
        | jq -r '.offerings[0].product_id')
$ aggregate-plus mcp create-order "$TOP" "$PROD" --tier professional

Same payload shapes as the SDK and the REST API. If you can read the spec at /developers/docs, you can script the CLI.

What's next

Same surface. Pick your runtime.

The CLI wraps the SDK. The SDK wraps the REST API. The REST API fronts the same data the MCP server hands to AI agents. One source of truth — four ways in.