0.1.8

npm

@0xray/grok-bot

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.

Published28 Sept 2026

Direct dependencies0

Transitive dependenciesNot calculated

README

Current package documentation

@0xray/grok-bot

Start here

Read first: OP-PROC.md — the one-page operating procedure.

Board: house/WAVEBOARD.md when LIVE_URL is unset, and Bifrost cards (GET /cards) when LIVE_URL is set, plus 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/, including watchers/ and fleet/, and refuses to overwrite. house init --migrate moves an old ops/WAVEBOARD.md into house/WAVEBOARD.md, starts missing files, and appends the template ## Cadence block when HOUSE.md lacks it. When both boards exist and house/WAVEBOARD.md is not the untouched template, migrate exits 1 and writes nothing. It does not overwrite a ledger.

House file	What
`house/HOUSE.md` `## Cadence`	Optional. Delete it when the house has no code loop. Defaults: opproc-cadence.md
`house/watchers/merge-queue.md`	Lab tester's retest ledger
`house/watchers/review-sent.log`	Reviewer dedupe log (PR + SHA)
`house/watchers/stall-sweep.log`	One line per stall nudge
`house/watchers/issue-sweep-last.txt`	Issue-sweep cursor (one UTC time)
`house/watchers/waveboard-static.md`	Notes beside the hand-kept board. Not merged into `house/WAVEBOARD.md`
`house/fleet/activity.jsonl`	Live-mesh activity (`BURST_ACTIVITY`)
owner prompt	Board rule. On every owner message run `live-inbox <seat> --prompt --from owner --note "<gist>"`. Ack a handled line with `live-inbox <seat> --ack <id>`, or `live-inbox <seat> --ack all` once every open line is handled. A cloud agent run uses `live-inbox <seat> --turn start --tag "bc-<first8> <track>"` and `live-inbox <seat> --turn end --tag "bc-<first8>"`. `--from owner` is required today. Kanban note. The live page shows a read-only kanban above Activity. Columns are open, review, fix, merge, retest, and done. The deep link is `?card=`. History note. Every activity line is archived to history. The word owner is the owner via LIVE_OWNER or the owner-name.
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-bot

Seat 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 --json

Plain: 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. When ## Cadence is present, doctor also warns (and does not fail) if review-sent.log or stall-sweep.log is missing or older than 2 hours, if the activity log's last line is not JSON with t_ct, kind, action, and seat, or if the suit .xray/codex.json term count or lastUpdated differs from node_modules/0xray. When watchers/ exists and Cadence is missing, doctor hints grok-bot house init --migrate.

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)
Label — seat-label in that seat’s own chat (UpdateProfile title only)

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. Cadence defaults live in opproc-cadence.md.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 0

Native requirements

0 direct targetsNot calculated transitive count

No declared dependencies in this collected response

Declarations describe requirements; they are not a resolved dependency graph.

Distribution files

1 collected

Distribution 1

Source distribution

Source file

Checksums from source

{
  "shasum": "d9e3df01276f5a163728e6654014c7a06aa75930",
  "tarball": "https://registry.npmjs.org/@0xray/grok-bot/-/grok-bot-0.1.8.tgz",
  "fileCount": 22,
  "integrity": "sha512-rJhiAOXwBNNV60qc3vsLh5syqFn2Vyabxplv3wtIEkzOSKAB3h5Q3QS8lLQvMZ41bYlhpqHl8koi+RQbdrxjYg==",
  "signatures": [
    {
      "sig": "MEQCIDKJc2YzsTpYnExFz+9tz+sIAvD2ip4wfKIobEqNvvrzAiB59aj4JVbQzVp2juG21hDG0RF6uMtGpRUsqKS4OQaBMw==",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    },
    {
      "sig": "MEUCIQDTQ1/PXNy2szFTeb99+vAtvUXI9lMk/jPBfhohS1GpJQIgKDwVgB16TI6tjjcHybY8rLbljEFB+P4U3QaJnFkBZLE=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 55289
}

Repository

PENDING

0xrayai/xray

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 21 Oct, 09:37 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:83ea2fa01737b9abe0ee8335300f0fbba966a3fb17895199bbe42ba666498d28

Other collected versions

0.1.1120 Oct 0.1.1019 Oct 0.1.92 Oct 0.1.727 Sept 0.1.626 Sept 0.1.517 Sept View all collected versions →