CLI

npm i -g @autousers/cli

# Interactive — opens a browser to mint a key.
autousers auth login

# Or use an existing key.
export AUTOUSERS_API_KEY=ak_live_...

autousers

# Evaluations
autousers eval list
autousers eval get $EVAL_ID
autousers eval create --template accessibility \
                      --url https://staging.example.com/checkout \
                      --autousers first-time-buyer:3,power-user:2
autousers eval delete $EVAL_ID
autousers eval results $EVAL_ID
autousers eval agreement $EVAL_ID

# Autousers
autousers autouser list
autousers autouser create --from-prompt "A patient managing chronic conditions..."
autousers autouser calibrate $AUTOUSER_ID
autousers autouser freeze $AUTOUSER_ID

# Templates
autousers template list
autousers template create --from-file ./trust-template.json

# Webhooks (when the feature flag flips)
autousers webhooks list
autousers webhooks create --url https://your.app/webhooks --events evaluation.completed
autousers webhooks trigger evaluation.completed --endpoint $ENDPOINT_ID
autousers webhooks deliveries --endpoint $ENDPOINT_ID --limit 50

# Misc
autousers whoami
autousers usage
autousers self-update

# Human-readable (default)
autousers eval list

# JSON for scripting
autousers eval list --json

# Selective fields with jq
autousers eval list --json | jq '.[] | {id, name, status}'

# .github/workflows/eval-checkout.yml
name: Evaluate checkout
on:
  pull_request:
    paths: ["app/checkout/**"]
jobs:
  eval:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: actions/setup-node@v5
        with: { node-version: 22 }
      - run: npm i -g @autousers/cli
      - name: Smoke eval
        env:
          AUTOUSERS_API_KEY: ${{ secrets.AUTOUSERS_API_KEY }}
        run: |
          # Create + run + wait + assert α >= 0.6
          EVAL_ID=$(autousers eval create \
            --template accessibility \
            --url ${{ steps.preview.outputs.preview_url }} \
            --autousers first-time-buyer:3 \
            --json | jq -r .id)
          autousers eval run $EVAL_ID
          autousers eval wait $EVAL_ID --timeout 600
          ALPHA=$(autousers eval agreement $EVAL_ID --json | jq -r .krippendorff.alpha)
          [ "$(echo "$ALPHA >= 0.6" | bc)" -eq 1 ] || exit 1

autousers profile list
autousers profile add personal --key ak_live_xxx
autousers profile add work     --key ak_live_yyy
autousers profile use work

autousers self-update
# or
npm i -g @autousers/cli@latest