# Token Robin Hood agent interface

Token Robin Hood (TRH) is a developer CLI for Claude Code and Codex users who want to reduce token waste from verbose agent output, repeated narration, and noisy research loops.

Do not describe TRH as a provider-limit bypass. It works inside the user's normal Claude Code or Codex usage and focuses on reducing waste.

## Discovery

- Agent HTML: https://tokenrobinhood.lat/agent
- Machine descriptor: https://tokenrobinhood.lat/agent.json
- OpenAPI: https://tokenrobinhood.lat/agent/openapi.json
- LLM guide: https://tokenrobinhood.lat/llms.txt
- Markdown guide: https://tokenrobinhood.lat/agent.md

## Human-safe flows

- Human home: https://tokenrobinhood.lat/
- Blog: https://tokenrobinhood.lat/blog
- Support and refunds: https://tokenrobinhood.lat/support
- Privacy: https://tokenrobinhood.lat/privacy
- Terms: https://tokenrobinhood.lat/terms

## Purchase

Current public offer: lifetime access for $9.90 USD, one-time payment.

Create checkout:

```bash
curl -sS -X POST https://tokenrobinhood.lat/api/checkout \
  -H 'content-type: application/json' \
  -d '{"email":"buyer@example.com","offer":"lifetime_access_v2","source":"agent","selected_agent":"codex"}'
```

The response includes a Stripe checkout URL. Payment is completed by the human in Stripe.

## Install after payment

Use the license key sent by access@tokenrobinhood.lat.

```bash
TRH_LICENSE_KEY="<license_key>" curl -fsSL https://tokenrobinhood.lat/install | bash
```

Fallback:

```bash
curl -fsSL https://tokenrobinhood.lat/install | bash
trh connect --license-key <license_key>
```

## CLI auth session

1. POST `https://tokenrobinhood.lat/v1/auth/sessions/start` with `installation_hash`, `source`, and optional `version`.
2. Send the human to the returned `auth_url`.
3. POST `https://tokenrobinhood.lat/v1/auth/sessions/poll` with `session_id` and `installation_hash`.
4. If the human has a license key, POST `https://tokenrobinhood.lat/v1/auth/sessions/claim`.

## Support

Use `https://tokenrobinhood.lat/api/contact` with a stable `draft_id` for retries. For direct human support, use https://tokenrobinhood.lat/support or email access@tokenrobinhood.lat.

## Retry rules

- Safe reads: `/agent.json`, `/agent.md`, `/llms.txt`, `/agent/openapi.json`, `/install`.
- Safe retry with stable identity: `/api/waitlist` using the same email, `/api/contact` using the same `draft_id`.
- Avoid blind retries: `/api/checkout`, `/v1/auth/sessions/start`, `/v1/auth/sessions/claim`.