ops

An opinionated, batteries-included development CLI operator.

Installation

Homebrew (macOS and Linux)

brew install rsvalerio/tap/ops

Local development

cargo install --path crates/cli

Quick start

# Initialize config for your project (auto-detects stack)
ops init

# Run a command
ops build

# Run static checks (fmt, check, clippy, build)
ops verify

# Run tests and quality checks
ops qa

# Add a new command interactively
ops new-command "cargo fmt --check"

Configuration

Create a .ops.toml file in your project root (or run ops init):

[output]
theme = "classic"        # "classic" (default) or "compact"
columns = 80             # line width for step lines
show_error_detail = true # show error details below failed steps

[commands.build]
program = "cargo"
args = ["build", "--all-targets"]

[commands.test]
program = "cargo"
args = ["test"]

[commands.verify]
commands = ["fmt", "check", "clippy", "build"]
parallel = true
fail_fast = true

[commands.qa]
commands = ["test", "deps"]
parallel = true
fail_fast = true

Config is merged in order: built-in defaults → global config → local .ops.toml → env. When run inside a project with a detected stack (e.g. Rust), ops init pre-fills stack-specific commands.

Commands

Stack-agnostic CLI (same on every stack)

Command	Description
ops <name>	Run a configured command or command group
ops init	Create .ops.toml (use --force to overwrite; --commands emits stack defaults)
ops new-command	Add a new command from a command line string
ops theme list|select	List or select output themes
ops extension list|show	List compiled-in extensions
ops about [setup|code|coverage|dependencies|crates|modules]	Project identity card and subpages
ops run-before-commit [install]	Pre-commit hook runner
ops run-before-push [install]	Pre-push hook runner

Stack-gated CLI

Command	Available on
ops deps	Rust
ops tools list|check|install	Rust
ops about coverage / dependencies	Rust
ops about crates / modules	Rust, Go

Stack command baseline

Every supported stack ships the same 7-command contract via ops init --commands. A ✓ means the command is active by default; * means it's emitted commented-out as a suggestion you can uncomment and adjust.

Command	Rust	Node	Go	Python	TF	Ansible	Java-M	Java-G
fmt	✓ (cargo fmt)	* (prettier)	✓ (go fmt)	✓ (ruff format, key format)	✓ (tf fmt)	* (ansible-lint --fix)	* (spotless)	* (spotless)
lint	✓ (cargo clippy, key clippy)	✓ (npm run lint)	✓ (go vet, key vet)	✓ (ruff check)	* (tflint)	✓ (ansible-lint)	* (spotless/checkstyle)	* (spotless/checkstyle)
build	✓	✓	✓	* (python -m build)	* (terraform plan)	* (galaxy build)	✓	✓
test	✓	✓	✓	✓ (pytest)	* (terraform test)	* (molecule test)	✓	✓
clean	✓ (cargo clean)	* (rm node_modules dist)	✓ (go clean)	* (rm caches)	* (rm .terraform)	* (rm .ansible)	✓	✓
verify	✓	✓	✓	✓	✓	✓	✓	✓
qa	✓	✓	✓	✓	✓	✓	✓	✓

Commented suggestions show up verbatim when you run ops init --commands, so you can opt in by uncommenting, or remap to the tool your project actually uses.

Stack parity matrix

Rust is the reference implementation; the other stacks are data providers compiled into the same binary via ops-extension. Parity gaps are feature scope, not separate language rewrites.

Stack flavors currently shipped:

• Rust — cargo (workspaces supported)
• Go — go modules / go.work
• Node — package.json (pnpm/yarn/npm workspaces)
• Java-Maven — pom.xml with <modules> multi-module support
• Java-Gradle — Gradle with settings.gradle(.kts) subprojects
• Python + uv — pyproject.toml (PEP 621) with uv workspace members from [tool.uv.workspace] / uv.lock. A generic Python flavor (poetry, pip/setuptools, pdm, etc.) is not yet implemented.

Area	Rust	Go	Java-M	Java-G	Node	Python+uv
CLI core (init, theme, extension, hooks)	✓	✓	✓	✓	✓	✓
7-command contract (fmt/lint/build/test/clean/verify/qa)	✓	✓	✓	✓	✓	✓
project_identity provider	✓	✓	✓	✓	✓	✓
Module count on identity card	✓	✓	✓ (modules)	✓ (subprojects)	✓	✓
project_units provider (about modules subpage)	✓	✓	✗	✗	✓	✓ (uv workspace only)
about code (tokei LOC, feature-gated)	✓	✓	✓	✓	✓	✓
about coverage (cargo llvm-cov)	✓	✗	✗	✗	✗	✗
about dependencies / ops deps	✓	✗	✗	✗	✗	✗
tools (manage stack tooling)	✓	✗	✗	✗	✗	✗

Ranked by closeness to Rust parity: Node and Python+uv (identity + units + baseline CLI), Go (~90%, weaker units provider), Java-Maven / Java-Gradle (identity + module counts, but no project_units provider yet for the about modules subpage).

Rust-only extensions: deps, tools, cargo-toml, cargo-update, metadata, test-coverage. about code is stack-agnostic (tokei scans any language) and only gated by the compile-time tokei feature on the ops binary; about coverage and about dependencies are Rust-only because their providers shell out to cargo llvm-cov / cargo metadata.

Not yet implemented

• Generic Python stack (non-uv: poetry, pip/setuptools, pdm, hatch)
• Java project_units provider — module counts already surface on the main about card (Maven modules, Gradle subprojects), but ops about modules can't list them per-unit until a project_units provider ships

Features

• Zero config — works out of the box with sensible defaults; ops init and othere to scaffold the rest
• Declarative commands — define commands and command groups in TOML
• Themed output — step lines with timing; switch between themes easily
• Extension architecture — compile-time extensions; build your own ops
• Parallel execution — run command groups concurrently with parallel = true

Backlog

• Review codebase looking for bad design, high cognitive load and lack of rust idioms and best practices
• Support conventional commit related commands: check git-cliff and cocogitto
• Support release related commands: check cargo-dist and go-releaser
• Make the about page "themed"
• Make the about page stack agnostic, with abstractions, each stack fill it up

Contributing

This project uses Conventional Commits. Only feat and fix commits trigger a release.

git commit -m "feat: add new feature"
git commit -m "fix: resolve bug"

See docs/releasing.md for the full release workflow.

Documentation

• Releasing — automated releases, conventional commits, Homebrew tap
• Visual Components — step icons, error boxes, theme comparison

License

Apache-2.0