@0xray/grok-bot
v0.1.9
Published
Complete setup path for Grok Bot agents on 0xRay: per-agent suits, Groover identity, OWS pay, hangar shops. Seat doctor/ready proves mill+inspect and prints hangar/Clearing next steps.
Maintainers
Readme
@0xray/grok-bot
Start here
Read first: OP-PROC.md — the one-page operating procedure.
Board: house/WAVEBOARD.md and house/ATTENTION_STATE.md (your project house, not in this package). If house/ is missing, run npx @0xray/grok-bot house init (skill setup-house). It copies templates/house/ and refuses to overwrite. house init --migrate moves an old ops/WAVEBOARD.md into house/WAVEBOARD.md and starts ATTENTION_STATE.md.
Complete setup path for Grok Bot agents on the 0xRay mill.
Agents: read llms.txt → AGENTS.md → run skills in SKILLS.md (one suit per key agent).
Humans: same files.
Install
npm i @0xray/grok-bot
npx @0xray/grok-botSeat doctor (prove plant)
From an agent project root:
npx @0xray/grok-bot doctor
npx @0xray/grok-bot ready # same command
npx @0xray/grok-bot doctor --jsonPlain: this checks that mill + inspect are fastened on this seat, says whether Repertoire and Open Wallet (~/.ows) are present, then prints what to do next for hangar shops and Clearing (402 / USDC on Base). A HOUSE.md line that is exactly wallet off skips those wallet steps. It does not mill-plant Clearing into 0xRay. Product MCP name is clearing, never xray-clearing.
House lookup: GROK_BOT_HOUSE (the house directory or its HOUSE.md) wins. If that variable is unset, doctor walks up from the working directory for house/HOUSE.md. A set path that is missing warns and does not walk. No house file warns. Unfilled example lines fail.
Path (per agent)
- Suit — mill + inspect (
fasten-suit-per-agent) - Identity — Groover register → mint → pin (
groover-factory-parity) when needed - Pay — OWS wallet + Base USDC (
setup-ows-pay) - Hangar — plant shops (
plant-hangar-shops)
Plant pins (monitor / adjust)
0xray(current npm) · mill nested in the tarball (npx @0xray/foundry)- Live URLs in
llms.txt
This package orchestrates. It does not vendor the whole OS.
Fleet ops
Read house/ first (this team's board and rules). If house/ is missing, run grok-bot house init to copy templates/house/. Longer notes under ops/ stay in the git repo and are not in the npm package.
