Overview
What opi is, what it covers, and how this documentation is organised.
opi — Operations Interface — is a project control center for your terminal. Go into any
repository, type opi, and get a usable interface for that project without configuring
anything first.
Its primary job is to be a better npm run: the start screen shows the project’s scripts,
grouped and labelled, with the package manager detected rather than typed. Health, security,
updates and clean sit one hotkey away, and three workflows run the right checks before a
commit, a push or a release — the push one as a pre-push hook if you want it binding.
Status: 0.11.0. npm, pnpm, bun and Cargo projects are covered; yarn’s scripts, health and
security audit are too — its update listing is not read yet. opi runs on macOS and Linux
only.
Where to start
- Installation — the install script or
cargo install opi. - Quickstart — the three ways to run a script.
- Scripts — how the list is grouped, and how it behaves in a monorepo.
- Command line — every flag and hotkey.
How it works
opi reimplements none of the tools it surfaces. It detects which one a project depends on —
Biome, ESLint, Prettier, tsc, astro check, Vitest, Jest, fallow, Knip, a secret scanner,
cargo — runs it, and relays what came back. Output is parsed only where the format is
documented (audit --json, outdated --json, audit signatures --json, licenses list --json).
The project’s own files are the only interface: package.json and Cargo.toml. There is no
opi.toml; an optional opi key in package.json refines what is already there.
Project documentation
The pages in this group describe the codebase as it stands — for contributors, and for
anyone who wants to know why opi behaves the way it does:
- Project state — what this is and where it stands
- Architecture — the modules and how they fit
- Constraints — the boundaries the implementation respects
- Conventions — the rules future changes follow
- Decisions — the decisions in force, and why