Errors

import reuseforge
from reuseforge import ReuseForgeError, PaymentRequiredError, RateLimitError

client = reuseforge.Client()
try:
    client.install("acme/paid-tool", target="claude-code", dest=".")
except PaymentRequiredError as e:
    print("buy first:", e.order_hint)           # the create_order request that buys it
except RateLimitError as e:
    print("slow down, retry in", e.retry_after)
except ReuseForgeError as e:
    print(e.status, e.code, e.detail, e.request_id)

import { ReuseForge, PaymentRequiredError, RateLimitError, ReuseForgeError } from '@reuseforge/sdk';

const client = new ReuseForge();
try {
  await client.getInstallDescriptor('acme/paid-tool');
} catch (e) {
  if (e instanceof PaymentRequiredError) console.log('buy first:', e.orderHint);
  else if (e instanceof RateLimitError) console.log('retry in', e.retryAfter);
  else if (e instanceof ReuseForgeError) console.log(e.status, e.code, e.detail, e.requestId);
  else throw e;
}

# -f makes curl fail on 4xx/5xx; the problem document is still printed with --fail-with-body
curl --fail-with-body -sS https://reuseforge.com/api/v1/items/acme/missing || true

rf items get acme/missing --json     # exit code 4; stdout carries the problem plus exit_code
echo $?