- assume tsq is already built and installed in path. if not build and install it.
- use parallel sub-agents and agent teams for implementation.
Simple local-first tracker for local agent work, inspired by Beads patterns. Local-first. Git-friendly. JSONL-backed. Durable across restarts and context compaction.
- task/feature/epic create/read/update
- typed dependencies (
blocks,starts_after) - relation links
- duplicate workflow (
duplicate,duplicatesdry-run scaffold) - merge workflow (
mergewith--forceand--dry-run) - ready detection
- lane-aware ready detection (
--lane planning|coding) - planning state tracking (
planning_state) - deferred lifecycle status for parked work
- atomic claim
- optional claim spec gate (
--require-spec) - spec attach/check workflow
- supersede workflow
- orphans reporting (
tsq orphans, read-only) - append-only audit trail
- stable machine output (
--json) - tree list view (
tsq list --tree) - skill install/uninstall via
tsq init
- sqlite/dolt backends
- remote sync service
- background daemon
- multi-machine consistency
- Runtime: Rust
- Language: Rust
- TUI : OpenTUI, use
opentuiskill. - Validation: strongly typed domain + parser checks
- Output: JSON envelopes + terminal rendering
For storage model, task model, CLI contract, JSON output format, durability rules, repo conventions, and finishing-task checklists, see AGENTS-reference.md.