@e9n/pi-td

Task management extension for pi — structured td tool with mandatory workflow enforcement and an optional web dashboard.

Features

• td tool — full task lifecycle: create, start, log, handoff, review, approve/reject, close, block/unblock
• Workflow enforcement — system prompt injection ensures every code change has a task and a feature branch
• Web dashboard at /tasks — board, table, and tree views (requires pi-webserver)
• Cross-project view — scan multiple repos under a root directory
• REST API at /api/td/* — CRUD, review flows, and activity logs

Settings

Add to ~/.pi/agent/settings.json or .pi/settings.json:

{
  "pi-td": {
    "webui": true,
    "crossProjectRoot": "~/Dev",
    "crossProjectDepth": 1
  }
}

Setting	Type	Default	Description
webui	boolean	true	Enable the web dashboard
crossProjectRoot	string	—	Root directory to scan for .todos/ databases
crossProjectDepth	number	1	Subdirectory scan depth

Tool: td

Query actions

Action	Required params	Description
status	—	Current session and task summary
list	—	List open issues (filterable by type/priority/status/labels/epic)
show	id	Show full issue detail
ready	—	Issues ready to start
next	—	Best next issue to work on
reviewable	—	Issues awaiting review
search	query	Full-text search across issues

Lifecycle actions

Action	Required params	Description
create	title	Create a task (type, priority, description, labels, parent, minor)
start	id	Mark in-progress
log	message	Add a progress log entry (log_type: progress/blocker/decision/hypothesis/tried/result)
handoff	id	Record handoff (done, remaining, decisions, uncertain)
review	id	Submit for review (minor to allow self-review)
approve	id	Approve and close (auto-creates review session if needed)
reject	id	Reject with optional reason (auto-creates review session if needed)
close	id	Close task (self_close: true to close own work)

Modify actions

Action	Required params	Description
update	id	Update task fields (title, type, priority, description, labels, parent)
delete	id	Soft-delete an issue

Focus actions

Action	Required params	Description
focus	id	Set current working issue (without starting)
unfocus	—	Clear focus

Other actions

Action	Required params	Description
block	id	Mark as blocked
unblock	id	Remove blocked status
reopen	id	Reopen a closed issue
comment	id, message	Add a comment

List/search filters

Parameter	Description
show_all	Include closed issues
filter_type	Filter by issue type
filter_priority	Filter by priority
filter_status	Filter by status
filter_labels	Filter by labels (comma-separated)
filter_mine	Show only issues assigned to current session
filter_epic	Filter by parent epic ID
sort	Sort by field (e.g. priority, created, updated)
limit	Max number of results
query	Search text (for search action, or --search filter for list)

Web UI

Enable webui: true in settings, start the web server with /web, then open http://localhost:4100/tasks.

Requirements

• td CLI in $PATH — a local-first task management CLI for AI-assisted development workflows
• pi-webserver extension (only needed for web UI)

Installing td

# With Go installed:
go install github.com/marcus/td@latest

# Verify:
td --version

Install

pi install npm:@e9n/pi-td

License

MIT