0xray weekly downloads statistics

xray — a suit for coding agents

4.1 — a suit that survives the context window

Bifrost is the live board. Goggles views one plane. A search runs inside that card.

0xRay is a three-subsystem autonomous engine. The suit is the wear. Inference remembers. External Governance judges. The Autonomous Engine runs the work. The host you already run wears it: Grok, OpenCode, Hermes, OpenClaw, or Cursor. Memory, judgement, and payments come on with the suit. When the window closes, the next session wakes with the job, the page, and the laws.

Bifrost turns each pull request, issue, and comment into one card and a line in the right seat's inbox, then wakes that seat. Confer still completes only on a real yes. A foundry is built from mills and hangars. The mill builds and ships. The hangar is the shop.

The product is the skeleton you wear.

Your AI Power Suit

Your AI Power ⚡️ Suit 🦾 — an exoskeleton that blocks AI slop from becoming real damage.

• Bone — three-subsystem engine: Inference · External Governance (Dynamo / Codex) · Autonomous Engine (thinDispatch)
• Always on — Codex 11 / 29 / 69, destructive shell, no new MCP/skill/handler surface
• Temperament — frontier | guided | strict | auto — how loud the engine is, not whether governance exists
• Wear — Grok, OpenCode, Hermes, OpenClaw, plus Cursor project hooks. One SSOT gate
• Muscle — Repertoire is preferred. Vendored 0.2.9 ships on. Dest is named laws, not hangar repo-* or git slugs. Station is the wake ticket — not a substitute for Repertoire.

npm install 0xray
npx 0xray wear

Wear links vendored @0xray/repertoire and writes the consumer suit, including when npm did not run the install script. When that script does run, it symlinks vendored @0xray/repertoire into node_modules, prints npx 0xray wear, and does not write .mcp.json or the chat bridges. Wear writes the consumer suit: managed AGENTS.md, .xray config, seven MCP servers, and the OpenCode, Grok, Hermes, and OpenClaw bridges (install-bridges.cjs). Inside a git checkout, wear also fastens Cursor project hooks. Repertoire is preferred — vendored 0.2.9 ships on: factory + stack laws, in-process routing, extra host MCP repertoire. Not an eighth xray-* server. Dest is a judgment index. Explicit opt-out only: "enabled": false, "provider": "repertoire". Do not pin 0.1.8.

Quick Start

npm install 0xray
npx 0xray wear
npx 0xray status
npx 0xray setup --git-hooks # optional: git hooks only
npx @0xray/foundry inspect --skip-live # mill receipt (chat is not a receipt)

Manual per-platform install (idempotent, same bridges wear writes):

npx 0xray opencode install
npx 0xray grok install # 7 MCPs servers + project .grok/plugins/0xray (not machine last-wins)
npx 0xray hermes install
npx 0xray openclaw install
npx 0xray skill:install # starter skills

Autonomy command (default operating model)

When the suit is worn, autonomy-command is ON by default: lead dev takes helm, phased todos, best subagent per task, per-suite test triage, loop until green. No keywords required. Slash: /autonomy-command

Docs: guides/autonomy-command · Skill: src/skills/autonomy-command/SKILL.md

What's New Since 3.1

Version	Highlights
4.1.0	Bifrost is the collector board. A cloud agent is a board row. A stuck card's L2 nudge goes to the CoS role. live-inbox requires LIVE_URL, SEAT_KEYS_DIR, and LIVE_CURSORS. Goggles views one plane. The card is in LENS.md. A search runs inside that card.
4.0.43	Confer completes only on a real PASS. Cursor gate events fail closed, except EACCES when a cloud wrapper cannot write dest. Gate C cannot be skipped.
4.0.42	Confer votes. Burst runs the swarm.
4.0.41	Wake cascade stays on the station module. A fresh wear fastens mill and inspect. Goggles records the worn package path. The live page plays the mesh in the browser.
4.0.40	Live mesh runs the full loop: feed watch, render, direction, deploy, health, and the ledger both ways.
4.0.39	The seven stack laws stay worn. Repertoire in the suit is 0.2.9.
4.0.38	Codex term 70 requires the current source and the worn npm package. Dynamo's recommendation is honored.
4.0.37	A naked checkout wakes with repertoire on.
4.0.36	Goggles holds the stop through search, read, and a dist wipe.
4.0.35	Wear rewrites a checkout dist/cli launch to node_modules/0xray.
4.0.34	The lens stays on the worn build when the source is not packed.
4.0.33	Version bump.
4.0.32	0xray look opens one plane. Digest and triage return the card. Calling and confer stay off.
4.0.31	Goggles looks at one pipeline. Kind 0 stays quiet when the worn list matches the map. Calling and confer stay off.
4.0.30	Fixes 4.0.29: npx 0xray wear and setup work outside a git checkout again. They write the 4.0.28 project setup, skip only Cursor hooks, and print one warning. Inside a git checkout they restore the 4.0.28 project setup, and wear adds Cursor hooks plus the unwear snapshot. Companion @0xray/grok-bot 0.1.8. Released 2026-09-28.
4.0.29	npm install only creates the relative node_modules/@0xray/repertoire link to the vendored repertoire and prints npx 0xray wear. Run npx 0xray wear after install. Wear writes only the consumer project's .cursor/hooks.json (installed dist hooks, beside user entries); npx 0xray unwear restores the snapshot. Companion @0xray/grok-bot 0.1.8. Released 2026-09-28.
4.0.28	MCP servers start through scripts/node/mcp-launch.cjs and only see PATH, HOME, XRAY_ROOT, plus names on their keep list. Tokens such as NPM_TOKEN…