cxq v0.1.0

cxq v0.1.0

First public release of cxq, a tiny repo-local SQLite task queue for Codex CLI.

cxq is built for local coding-agent workflows: one task at a time, explicit claim/review semantics, useful context in prompts, and no SaaS dashboard in the middle.

Highlights

• Repo-local .codex/tasks.db SQLite queue
• Bash + sqlite3 + git, no server or daemon
• cxq add to create scoped tasks
• cxq claim-next --format prompt for Codex-ready task pickup
• cxq note, cxq show, cxq review, and cxq done
• Claim leases for crashed or abandoned agent runs
• Event history per task
• Non-destructive cxq install
• Agent guidance through AGENTS.md

Example

cxq install

cxq add "Fix flaky auth refresh test" \
  --files "src/auth/*,tests/auth/*" \
  --verify "npm test -- auth"

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

Install

Clone the repo and run:

./install.sh

Then, inside a Git repository:

cxq install

Notes

This is an early 0.1.0 release. The scope is intentionally small: local-first, repo-first, terminal-first.