Content
# r0x-os
The official SDK, Claude Code / MCP plugin, and facilitator docs for **r0x**,
the USDG-native operating system for AI agents, built on Robinhood Chain.
r0x runs the official x402 facilitator for Robinhood Chain. AI agents can use
it right now: discover a priced capability, authorize a USDG payment, and
invoke it, all in one uninterrupted call. No API keys, no subscriptions, no
human approving anything in between.
Live site: [projectr0x.dev](https://projectr0x.dev) · Facilitator docs: [docs/facilitator.md](./docs/facilitator.md) · Skill reference: [docs/skills.md](./docs/skills.md)
## What's in this repo
- **SDK** (`src/client`): a TypeScript client (`R0xClient`) that handles the
x402 challenge/sign/retry cycle automatically. Published as `r0x-os` on npm.
- **Claude Code / MCP plugin** (`src/plugin`): exposes the full skill catalog
as MCP tools, plus local wallet setup and a spend-limit guard.
- **Docs** (`docs/`): how the facilitator works and the full skill reference.
- **Examples** (`examples/`): a minimal, dependency-light reference client.
## Install
```bash
npm install r0x-os
```
```ts
import { R0xClient } from 'r0x-os';
const client = new R0xClient({ privateKey: process.env.R0X_PRIVATE_KEY });
// $0.01 USDG per call, settled automatically
const { data } = await client.price('ETH');
console.log(data.priceUSD);
const balance = await client.balance('0x...');
console.log(balance.data.balances);
```
See [docs/skills.md](./docs/skills.md) for every method the client exposes.
## Claude Code plugin
```
/plugin marketplace add nhevers/project-r0x
/plugin install r0x-os
```
Or add it directly as an MCP server:
```bash
claude mcp add r0x -- npx r0x-os
```
No private key is needed upfront, the agent calls `r0x_setup` on first use to
either import an existing wallet or generate a fresh one. After that, ten
tools are available: `r0x_setup`, `balance`, `tx`, `price`, `wallet`, `chat`,
`send`, `fund`, `broadcast`, and `spend_limit`. (`trade` is intentionally left
out, since no DEX aggregator indexes Robinhood Chain yet.)
## Building from source
```bash
git clone https://github.com/nhevers/project-r0x.git
cd project-r0x
npm install
npm run build # compiles src/ -> dist/
npm run example:tx # runs the reference test-transaction script
```
## How the facilitator works
Read [docs/facilitator.md](./docs/facilitator.md) for the full protocol walk-through,
or jump straight to [`examples/test-transaction.js`](./examples/test-transaction.js)
for a working ~80-line client.
## License
MIT, see [LICENSE](./LICENSE).
