CLI Reference¶

taskito provides a command-line interface for running workers and inspecting queue state.

Installation¶

The CLI is installed automatically with the package:

pip install taskito

The taskito command becomes available in your PATH.

Commands¶

taskito worker¶

Start a worker process that consumes and executes tasks.

taskito worker --app <module:attribute> [--queues <queue1,queue2,...>]

Examples:

# Start a worker using the queue defined in myapp/tasks.py
taskito worker --app myapp.tasks:queue

# Only process the "emails" and "reports" queues
taskito worker --app myapp.tasks:queue --queues emails,reports

# Use a nested module path
taskito worker --app myproject.workers.tasks:task_queue

The worker blocks until interrupted with Ctrl+C. It performs a graceful shutdown — in-flight tasks are allowed to complete before the process exits.

taskito info¶

Display queue statistics.

taskito info --app <module:attribute> [--watch]

Examples:

# Show stats once
taskito info --app myapp.tasks:queue

Output:

taskito queue statistics
------------------------------
  pending      12
  running      4
  completed    1847
  failed       0
  dead         2
  cancelled    0
------------------------------
  total        1865

# Live monitoring with throughput
taskito info --app myapp.tasks:queue --watch

Output (refreshes every 2s):

taskito queue statistics
------------------------------
  pending      3
  running      8
  completed    2104
  failed       0
  dead         2
  cancelled    0
------------------------------
  total        2117

  throughput   12.5 jobs/s

Refreshing every 2s... (Ctrl+C to stop)

App Path Format¶

The --app flag uses module:attribute format:

myapp.tasks:queue
│           │
│           └── attribute name (the Queue variable)
└── Python module path (dotted, importable)

The module must be importable from the current working directory. If your module is in a package, make sure the package is installed or the parent directory is in PYTHONPATH.

Common patterns:

Error Messages¶