LH Task Queue is a single work queue for human and AI agent tasks, with atomic claiming, dependency tracking, and MCP abilities. Tasks live as a dedicated post type; workflow state (New, Claimed, In Progress, Pending, Awaiting review, Failed, Resolved, Closed, Cancelled, Deferred) is tracked in a companion status table rather than native WordPress post_status, so an atomic claim/complete/fail/reassign lifecycle can run safely under concurrent access from multiple human and agent sessions.
Key features
- Atomic task claiming, highest priority first and then oldest (or one specific task), optionally narrowed to a queue and task type, with claim-token verification so concurrent sessions can’t double-claim the same task
- Dependency tracking via blocked_by: a task waiting on an unfinished prerequisite is never handed out, a claim that gets nothing says why, and if a prerequisite is cancelled or trashed the tasks waiting on it go to Pending for a person to check
- A review step for delegated work: when someone other than the person who asked marks a task done, it waits as Awaiting review until the person who asked (or staff) accepts it or sends it back with a note, and each side is told by notification and email. Tasks you give yourself, and agent work, close straight away
- Master tasks with subtasks, one level deep: the master’s page is a checklist of its subtasks with owners, due dates, days left or overdue and progress such as 3 of 5 done, and the master resolves on its own when every subtask is finished (or goes to Pending if one fails)
- Queue/lane and task-type taxonomies for routing
- Stale-claim sweep every five minutes (on Action Scheduler where it is available, otherwise WP-Cron) to recover tasks left claimed by a crashed or disconnected agent, with a renew-claim heartbeat so a still-live long-running claim can stay ahead of the sweep
- Task context on every write ability, on every site: any ability that changes something accepts an optional task_id and claim_token. The call is refused if the claim has been lost, a successful call keeps the claim alive up to a maximum lease (4 hours by default), and each call is counted on the task
- Full MCP ability surface: create, update, add-note, claim-next, complete, complete-assigned-task, review-task, fail, reassign, renew-claim, edit (staff override), get, list. Tasks keep revisions, so an overwritten title or description can be recovered
- Task listing that finds any task: filter by one or several statuses or a status group, priority, queue, task type, claim holder, assignment, master task, source, due date or overdue, when created or last updated, whether a prerequisite is holding it back, and text in the title or description; sort by priority, age, last update or due date. Listings return a compact set of fields by default (title, status, queue, priority, due date, assignment, blocking, master task) and give descriptions, payloads or the progress log only when asked, so they stay small enough for an agent to read
- A Tasks tab on each member’s own BuddyPress profile, for people who are given tasks but have no staff access: it lists the open tasks assigned to them or asked for by them, each linking to the task’s own page, where they can see its timeline, add notes, mark their tasks done, and accept or send back tasks they asked for, without going into wp-admin
- Dashboard widget and admin list-table columns for at-a-glance workflow status and subtask progress
Install & setup
Network-activate the plugin (requires WordPress 7.1 and LH Content Converter). Tasks are created via the MCP abilities or programmatically via LH_Tasks_task_actions_class::create_task().
