Command-Line Interface (CLI)¶

Nuvom ships with a powerful developer-first CLI for running workers, inspecting jobs, managing plugins, and more.

Run the following to get started:

nuvom --help

Worker Control¶

nuvom runworker

Starts the dispatcher and worker pool based on your .env settings.

nuvom inspect job <job_id>

View full metadata, result, or traceback for a job.

nuvom status <job_id>

Quickly fetch a job’s final status.

nuvom history recent --limit 10 --status SUCCESS

See recent jobs by filter or limit.

nuvom discover tasks

Parses project source files using AST and updates the manifest.

nuvom list tasks

Displays all available @task functions registered in the manifest.

nuvom runtestworker run --input myjob.json

Execute a job directly from a JSON file (offline, no queue).

nuvom plugin test

Attempts to load all plugins from .nuvom_plugins.toml and verifies startup/shutdown.

nuvom plugin status

Shows plugins currently registered by name and type.

nuvom plugin scaffold --type queue_backend --name my_plugin

Creates a boilerplate plugin file with the correct structure.

nuvom config

Prints all loaded environment variables and configuration values.

Combine discover tasks and list tasks for troubleshooting discovery issues.
Use plugin test if your backends aren’t being picked up correctly.
runtestworker is useful for debugging serialization or runtime issues offline.