ops run

Execute a named command on a registered project using the TOML manifest registry. Commands are defined in the project's manifest file. Arguments after the command name pass through to the underlying command.

Synopsis

Invoke a manifest-defined command on a registered project

Terminal

$ops run <PROJECT_ID> <COMMAND_NAME> [args...]

Arguments

Argument	Description
PROJECT_ID	Project ID or alias (e.g. dbt, wdp-import, etl)
COMMAND_NAME	Command to execute (as defined in the manifest)

Any additional arguments are forwarded to the underlying command.

Flags

Flag	Type	Description	Default
--json	flag	Output as JSON for scripts and AI agents	—

Examples

Run dbt models matching the staging.* selector

Terminal

$ops run dbt run --select staging.*

Get the ETL project's status as JSON

Terminal

$ops run etl status --json

Run the wdp-import project's health check entry point

Terminal

$ops run wdp-import health

List Prefect deployments via the prefect project's manifest command

Terminal

$ops run prefect deployments

run vs exec

• ops run uses named commands registered in the project's TOML manifest — discoverable, reusable, and consistent across the team.
• ops exec runs arbitrary shell strings — useful for one-off commands not yet in the manifest.

Prefer run when the operation is repeatable; reach for exec only for ad-hoc work.