The operating layer for Node.js repos

One safe surface
for the work
around your tools.

npm installs. Git stores history. Test runners test. Scanners scan. But nobody owns the operating contract between them. xops does: it detects the repo, routes work to the right native owner, explains risk, and gives humans and code agents deterministic plans before anything dangerous happens.

$ npm install -g @x12i/xops

Or run without installing: npx @x12i/xops@latest --full-flow

Native tools keep authority. xops owns the operating contract.

Edge

One deterministic command surface across repo tools.

Value

Less archaeology, safer releases, clearer next steps.

Why now

Agents need contracts, not another shell prompt.

Try it in your browser, no install needed →

terminal
~ projects/my-app $ xops ops status ✓ npm workspaces detected ✓ git remote and branch state checked ✓ Vitest and ESLint configured ✓ release stack available ! Postman collection has no runner → xops recommendations $ xops ask "release the stack" --plan --json → command, argv, risks, approval, report path Done. Exit 0.

The positioning

The repository became
the operating surface.

xops started with the painful part of Node.js work: multi-package release. That proved the wedge. A real release is not one npm command; it is discovery, dependency order, install, build, test, pack safety, publish, push, journaling, and recovery. The same operating gap exists across the rest of the repo.

Modern repositories are operated through package managers, git, branch workflow tools, CI, tests, scanners, dependency bots, API collections, deployment config, and code agents. Each tool owns a domain. xops owns the contract between domains.

One operating surface, top to bottom

Human developer
Code agent
xopsdetect · route · plan · execute · report
npm / pnpm / yarn git GitButler CI tests linters Renovate / Dependabot security scanners MaGit utilitix deploy & observability

Why it exists

Repo work crosses tool boundaries. Without a contract, humans do archaeology and agents guess. xops turns repo state into an operating plan.

What is different

xops is not another package manager, git client, scanner, or CI engine. It keeps native owners in charge and adds routing, safety, memory, and approval boundaries.

What you get

Fewer commands to remember, fewer missed steps, safer publish paths, clearer failures, and machine-readable plans agents can consume without hanging.

The package manager installs. Git stores history. The tools do their jobs. xops operates the repository.

What xops gives you back

Why
Why releases became events

npm does its job. The workflow around it — ordering, safety, sequencing — nobody built that part.

Learn why →
Operations
One surface for the tools you already use

xops ops status detects what exists across the repo — read-only, no setup, no surprises.

See operations →
Recommendations
Missing capabilities, only when they make sense

Evidence-based suggestions, not a generic checklist. Already-present tools are never recommended again.

See how →
Tools
Supported does not mean replaced

Package managers, CI, security scanners, MaGit, utilitix, and more — each tool keeps its job.

See supported tools →
Seamless tools
One habit. Every tool stays reachable.

Type xops for the next step — branch work routes straight to GitButler, no second CLI to remember.

See seamless routing →
Safety
Ship fast. Nothing leaks.

Pack check, sensitive-file block, post-bump re-validation — before anything reaches the registry.

Publish safety →
Security
Block Phantom Gyp before install

Tarball inspection catches weaponized binding.gyp — no CVE, no advisory required.

Install security →
Ask
Plain English. Exact command.

Deterministic phrase catalog — not an LLM. Same input, same command. Safe to script.

See how →
Try
Type it. Watch it resolve.

No install needed — the same phrase catalog, running live in your browser.

Try it now →
Agents
Built for the agent. Trusted by you.

JSON plans, deterministic exits, no hidden prompts — plus what an agent can run without approval, and what still needs your --yes.

The agent contract →
Stacks
Release order from the stack file

dependsOn controls publish order. Local file: dev links sync to registry ranges for publish, then restore.

Stack releases →
Upstream
Fix upstream. Don't fork.

Submit fixes, pull the fixed version, verify. Change requests become traceable — not permanent workarounds.

See how →
Undo
Run it. Undo it if needed.

Every run is journaled. One command restores the exact prior state. Try things without consequences.

See how →
Apply
Recommendations are read-only. Apply is explicit.

Setup plans show packages, files, commands, risks, and approval requirements before anything changes.

See how →
xgit
Git-first. Same package.

xgit status, xgit push — natural git passthrough plus monorepo cross-solve.

xgit vs xops →
Scripts
Tiered publish scripts + runbooks

xops scripts init and init runbook — preflight, core, ordered publish shell for agents.

Monorepo scripts →
Exports
Fix ESM/CJS package contracts

xops exports fix normalizes import/require export maps when dual build artifacts exist.

Package exports →
Install
One install. Runs anywhere.

Global, npx, or CI — same command everywhere. Run xops doctor to verify your environment.

Get started →
FAQ
Common questions

Does it replace npm? Is ask an LLM? What if publish works but push fails?

Read FAQ →
Commands
Full flags & commands

Every flag, passthrough rule, and copy-paste example in one place.

See all →

What runs when you type one command

$ xops --full-flow
01
Discover

Find all packages under the current directory

02
Graph

Sort local packages by dependency order

03
Tarball gate

Scan new dependency tarballs for Phantom Gyp before install

04
Install

Align dependencies before build and test

05
Build

Run builds in correct order, stop on failure

06
Test

Block the publish path if tests fail

07
Pack safety

Inspect what npm would actually publish

08
Publish

Hand off to real npm binary, in order

09
Report

Structured result for humans, CI, and agents

→ The release workflow becomes something you run, not something you remember.

Open source · MIT

100% free.
That's it.

xops is MIT licensed — free for personal and commercial use. No trial, no tiers, no expiry. One install. Everything included.

✓ MIT license ✓ Use anywhere ✓ No account required ✓ No paid tiers ✓ No feature gates ✓ No expiry date
$ npm install -g @x12i/xops
Install guide + all commands →