Taskboard CLI
SQLite-backed task management for multi-agent projects. No network calls, no credentials, no environment variables.
Quick Start
CODEBLOCK0
Custom Database Path
By default the database lives at scripts/taskboard.db. Override with --db:
CODEBLOCK1
Task Statuses
INLINECODE2 → in_progress → INLINECODE4
Also: blocked, INLINECODE6
No "review" status — use hooks to create follow-up tasks or notify agents.
Hooks (Cross-Agent Orchestration)
Hooks fire when task status changes. They print instructions to stdout for the calling agent to execute — no auto-execution, no network calls.
CODEBLOCK2
Hook output format:
CODEBLOCK3
The agent reads these lines and decides how to act (send a message, spawn a session, create a task, etc.).
Data Model
- - tasks — id, title, description, acceptancecriteria, status, priority, assignedto, createdby, parentid, threadid, onack, ondone, timestamps
- taskcomments — per-task comment history
- task_updates — audit log of all field changes
Schema auto-initializes on first run. Upgrades from v1 (missing onack/ondone columns) are handled automatically.
Reference
- -
references/webhook-integration.md — How to add Discord/webhook notifications on top of taskboard - INLINECODE8 — Syncing tasks with GitHub Issues
- INLINECODE9 — Task lifecycle, cross-agent handoff protocol, cron integration
Taskboard CLI
基于SQLite的多代理项目任务管理。无需网络调用，无需凭证，无需环境变量。
快速开始
bash
创建任务
python3 scripts/taskboard.py create 构建认证模块 --assign code-engineer --priority high
python3 scripts/taskboard.py create 设计用户界面 --assign designer --criteria 响应式设计，移动优先
管理任务
python3 scripts/taskboard.py update 1 --status in_progress --author code-engineer
python3 scripts/taskboard.py comment 1 PR #42 已就绪 --author code-engineer
python3 scripts/taskboard.py update 1 --status done --author code-engineer --note 已合并至主分支
查看看板
python3 scripts/taskboard.py list --status in_progress
python3 scripts/taskboard.py show 1
python3 scripts/taskboard.py show 1 --json
python3 scripts/taskboard.py summary
子任务
python3 scripts/taskboard.py create 编写测试用例 --parent 1 --assign code-engineer
线程关联
python3 scripts/taskboard.py set-thread 1 1484268803994026085
python3 scripts/taskboard.py get-thread 1
变更历史
python3 scripts/taskboard.py history 1
自定义数据库路径
默认情况下数据库位于 scripts/taskboard.db。可通过 --db 参数覆盖：
bash
python3 scripts/taskboard.py --db /path/to/my.db list
任务状态
todo → in_progress → done
其他状态：blocked、rejected
无review状态——请使用钩子创建后续任务或通知代理。
钩子（跨代理编排）
钩子在任务状态变更时触发。它们向标准输出打印指令供调用代理执行——不自动执行，无网络调用。
bash
任务启动时（确认后），打印通知指令
python3 scripts/taskboard.py create 构建认证模块 \
--on-ack message:CHANNEL
ID:🔨 {task.title} 已由 {task.assignedto} 开始处理
任务完成时，指示代理创建审查任务
python3 scripts/taskboard.py create 设计用户界面 \
--on-done session:tech-lead:审查 {task.title} 并创建QA任务
为现有任务添加/更新钩子
python3 scripts/taskboard.py update 1 --on-done message:CHANNEL_ID:完成！
钩子输出格式：
🔔 ONACK: message:CHANNELID:🔨 构建认证模块已开始
🔔 ON_DONE: session:tech-lead:审查构建认证模块并创建QA任务
代理读取这些行并决定如何行动（发送消息、启动会话、创建任务等）。
数据模型
- - tasks — id、title、description、acceptancecriteria、status、priority、assignedto、createdby、parentid、threadid、onack、ondone、时间戳
- taskcomments — 每个任务的评论历史
- task_updates — 所有字段变更的审计日志
模式在首次运行时自动初始化。从v1版本（缺少onack/ondone列）的升级会自动处理。
参考文档
- - references/webhook-integration.md — 如何在taskboard基础上添加Discord/webhook通知
- references/github-backend.md — 与GitHub Issues同步任务
- references/taskboard-setup.md — 任务生命周期、跨代理交接协议、定时任务集成
