# @0xray/grok-bot

> Complete setup path for Grok Bot agents on the 0xRay mill: suits (one per agent), Groover identity, OWS pay, hangar shops.

## Start
0. Read `OP-PROC.md` first (the one-page operating procedure).
1. Board: `house/WAVEBOARD.md` and `house/ATTENTION_STATE.md`. If a file is missing, use the same name under `templates/house/`.
2. Read `AGENTS.md` (order of operations + multiplicity).
3. Open `SKILLS.md` and run skills in order for **each** key agent.
4. No `house/` yet: `npx @0xray/grok-bot house init` (skill `setup-house`). It copies `templates/house/` and refuses to overwrite. Doctor uses `GROK_BOT_HOUSE` if set, otherwise walks up for `house/HOUSE.md`.
5. After a long chat or before coding: `skills/survive-compact/SKILL.md` — read disk, resume the live cloud, do not rebuild.

## Install
```bash
npm i @0xray/grok-bot
npx @0xray/grok-bot
npx @0xray/grok-bot doctor    # prove mill+inspect; print hangar/Clearing next
npx @0xray/grok-bot ready     # alias
```

## Live product URLs (plant)
- Factory /suit UI: https://website-production-c0da.up.railway.app/suit
- Registry MCP: https://registry-production-e2c4.up.railway.app/mcp
- Hangar shops (Clearing): https://clearing-production-9968.up.railway.app/
- OS docs: https://github.com/0xRayAI/xray/tree/main/grok-bot

## Depends on (do not vendor)
- `0xray` + `@0xray/foundry` — fasten mill+inspect
- Groover registry — register / mint / pin
- `groover-hangar` — plant shops
- Open Wallet (OWS) — local pay on Base USDC
- Board: `house/` first, else `templates/house/`
