huey-periodic

Package: z4j-hueyperiodic - Huey 2.5+.

Install

pip install z4j-hueyperiodic

Why read-only

Huey’s periodic tasks are defined via @huey.periodic_task(crontab(...)) decorators. You can’t “add a new periodic task at runtime” without adding code. The dashboard shows them; it cannot create new ones.

What you can do

Op	Supported
List all periodic tasks with their crontab	✓
Show next / last run	✓
Pause / resume an existing periodic task	✓ (calls disable() / enable())
Create / delete	✗ (requires code change)

Caveats

• Pause state is process-local. If you have multiple Huey consumer processes, pausing in one doesn’t affect others.
• The dashboard shows per-agent state so you can see the discrepancy.

For cluster-global pause semantics, consider pausing at the task level via a feature flag read inside the task.

Paired with

Huey.