pi-task

Kanban-style task management for pi-coding-agent — backlog, in-progress, review, blocked, done with SQLite persistence.

Installation

pi install npm:@0xkobold/pi-task

Or as part of the meta-extension:

pi install npm:@0xkobold/pi-kobold

Features

• 6-Column Kanban — Backlog, Needs Assignment, In Progress, Needs Review, Blocked, Done
• SQLite Persistence — Tasks survive restarts (stored in ~/.0xkobold/tasks.db)
• Session-Aware — Tasks are scoped to sessions
• History Tracking — All status changes are logged
• Parent/Child Tasks — Break down work into subtasks
• Comments — Add notes to any task

Tools

Tool	Description
task_breakdown	Break a request into kanban subtasks (creates task records, NOT agents)
task_list	List tasks, optionally filtered by status
task_update	Update task status or assignee

Commands

Command	Description
/task <title> [desc]	Create a new task
/tasks	Show the kanban board
/task-show <id>	Show task details
/task-move <id> <status>	Move task to a column
/task-assign <id> <assignee>	Assign a task
/task-comment <id> <text>	Comment on a task
/task-delete <id>	Delete a task

Kanban Columns

Column	Emoji	Description
Backlog	📋	Ideas and future work
Needs Assignment	👤	Ready to start, unassigned
In Progress	🏗️	Actively being worked on
Needs Review	👀	Completed, awaiting review
Blocked	🚫	Stalled, needs intervention
Done	✅	Completed and verified

Parameters

task_breakdown

Parameter	Type	Required	Description
request	string	✅	The original request being broken down
subtasks	array	✅	Array of { title, description?, priority? }

task_list

Parameter	Type	Default	Description
status	string	all	Filter by status
limit	number	20	Max results

task_update

Parameter	Type	Required	Description
taskId	string	✅	Task ID
status	string	❌	New status
assignee	string	❌	Assign to someone
note	string	❌	Note for status change

Architecture

┌─────────────────────────────────────┐
│           pi-task                    │
├─────────────┬───────────────────────┤
│  Extension  │  Store (./store.js)   │
│  (index.ts) │  - SQLite CRUD        │
│  - Tools    │  - History tracking    │
│  - Commands │  - Session scoping    │
└─────────────┴───────────────────────┘
         │                    │
         └─── bun:sqlite ───┘
              ~/.0xkobold/tasks.db

The ./store export path gives direct access to the data layer for programmatic use:

import { createTask, listTasks, getBoard } from "@0xkobold/pi-task/store";

const task = createTask("Build feature X", "Detailed description");
const board = getBoard();

Development

cd packages/pi-task
bun install
bun run build
bun test