Rustvello CLI¶
The rustvello binary provides command-line utilities for running workers, inspecting
invocations, and managing application data.
Installation¶
cargo install rustvello-cli
Commands¶
run — Start a Worker¶
Start a TaskRunner that processes queued invocations:
rustvello run [OPTIONS]
Option |
Description |
Default |
|---|---|---|
|
Application ID |
|
|
SQLite database path |
(in-memory) |
|
TOML configuration file |
— |
|
Force in-memory backends |
— |
|
Worker idle sleep in milliseconds |
|
Examples:
# Development — in-memory backends
rustvello run --memory
# Single-host production — SQLite persistence
rustvello run --app-id my-app --db-path ./tasks.db
# From config file (Redis, Postgres, etc.)
rustvello run --config config.toml
status — Check Invocation Status¶
rustvello status <INVOCATION_ID> [OPTIONS]
Option |
Description |
|---|---|
|
SQLite database path |
|
TOML configuration file |
Example:
rustvello status 550e8400-e29b-41d4-a716-446655440000 --db-path ./tasks.db
list — List Invocations¶
rustvello list [OPTIONS]
Option |
Description |
|---|---|
|
Filter by status: |
|
Filter by task ID (format: |
|
SQLite database path |
Example:
rustvello list --status RUNNING --db-path ./tasks.db
rustvello list --task my_crate.process_order --db-path ./tasks.db
purge — Delete All Data¶
rustvello purge [OPTIONS]
Option |
Description |
|---|---|
|
SQLite database path |
|
Skip confirmation prompt |
Warning
purge deletes all broker queues, invocations, results, and heartbeat records.
This action is irreversible.
info — System Information¶
rustvello info
Prints version, compiled feature flags, and runtime information.
config — Show Effective Configuration¶
rustvello config [OPTIONS]
Option |
Description |
|---|---|
|
TOML configuration file |
|
Application ID |
Prints the resolved AppConfig as TOML, merging all sources (file, env, defaults).
Useful for debugging configuration priority issues.
Environment Variables¶
All CLI options have corresponding RUSTVELLO__* environment variable equivalents.
Set them in your shell or a .env file:
export RUSTVELLO__APP_ID=my-app
export RUSTVELLO__DB_PATH=./tasks.db
rustvello run # picks up env vars automatically
See Configuration for the full environment variable reference.
| -y, --yes | Skip confirmation prompt |
info — Show System Information¶
rustvello-cli info
Displays version and build information.