Skip to content

v0.2.0

Choose a tag to compare

@daniel-aranda daniel-aranda released this 02 May 05:48
· 8 commits to main since this release

cxq v0.2.0

Dependency-aware release for cxq, the tiny repo-local SQLite task queue for Codex CLI and local coding agents.

This release makes claim-next smarter: tasks can now be blocked by other tasks, and agents will only claim work whose dependencies are complete.

Highlights

  • Adds dependency-aware task claiming
  • Adds SQLite-backed task dependency tracking
  • Adds commands to block and unblock tasks
  • Updates claim-next so blocked tasks are skipped
  • Preserves priority ordering among claimable tasks
  • Adds tests for blocked tasks, unblocked tasks, completed blockers, and invalid dependency cases
  • Updates docs and agent guidance for dependency-based workflows

Why it matters

Agents often work across multi-step implementation plans. Without dependencies, two agents can accidentally race through tasks in the wrong order.

With dependency-aware claiming, a queue can represent work like:

1. Create database schema
2. Build API client, blocked by 1
3. Implement collector, blocked by 2
4. Add reporting, blocked by 3

Then:

cxq claim-next --agent codex --lease 2h --format prompt

Only returns the highest-priority task whose blockers are already done.

Example

cxq add "Create initial database schema" --priority 100
cxq add "Build API client" --priority 90
cxq block 2 --by 1

cxq claim-next --format prompt

cxq will claim task 1, not task 2, because task 2 is blocked until task 1 is done.