taskboard (Tcarac)

任务板

一个本地的、自托管的项目管理工具，具有看板UI、完整的CLI和内置的 主控程序 服务器，让AI助手直接管理您的项目、工单和团队。

单二进制。SQLite支持。没有Docker，没有外部数据库，没有运行时依赖关系。

截图

Kanban Board

Ticket Detail

特性

• 看板 --在待办、进行中和完成列之间拖放工单管理
• 项目 --使用可定制的项目（图标、颜色、前缀）组织工作
• 团队 --为团队分配门票
• 门票 --优先级、截止日期、标签、子任务、依赖关系（被阻止）
• 嵌入式终端 --直接从web UI运行AI编码代理（opencode、Claude Code）
• 命令行界面 --从终端管理所有内容
• MCP服务器 --通过模型上下文协议进行人工智能原生项目管理的22个工具
• 自托管 --您的数据保存在SQLite数据库中的计算机上
• 单一二进制 --一个 brew install 而你正在奔跑

安装

家酿

brew tap tcarac/taskboard
brew install taskboard

来源

git clone https://github.com/tcarac/taskboard.git
cd taskboard
make build

需要Go 1.24+和Node.js 22+。

用法

Web 界面

taskboard start
# => http://localhost:3010

taskboard start --port 8080

命令行界面

taskboard project create "Auth System" --prefix AUTH --icon "🔐"
taskboard project list

taskboard ticket create --project  --title "Implement login" --priority high
taskboard ticket list --project  --status todo
taskboard ticket move  --status done

taskboard team create "Backend"
taskboard team list

MCP服务器（用于AI助手）

taskboard mcp

克劳德代码

claude mcp add taskboard -- /path/to/taskboard mcp

克劳德桌面

增添 ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "taskboard": {
      "command": "/path/to/taskboard",
      "args": ["mcp"]
    }
  }
}

数据层次结构

Project → Ticket → Subtask
(initiative)  (task)    (step)

• 项目 是顶级分组（如史诗/倡议）。为每个作品创建一个。
• 门票 是项目中具体、可操作的任务。不要创建“史诗”票——使用项目。
• 子任务 是工单中的检查表步骤，用于将工作分解为可验证的部分。

可用的MCP工具（22）

示例提示

一旦连接了MCP，你就可以用高级术语与你的AI助手交谈，让它找出故障：

I'm building a SaaS billing system. Set up the project and break the work
into tickets covering Stripe integration, usage metering, invoice generation,
and a customer billing portal. Prioritize accordingly.

I need to ship a password reset flow. Think through what's involved — API
endpoints, email templates, token handling, UI screens, tests — and create
tickets with subtasks for each piece.

Look at my board and figure out what's blocking progress. If anything in
"in progress" has been sitting there without subtasks, break it down into
concrete next steps.

这是一个完全由人工智能助手通过MCP创建的项目和票：

Project created by AI

Tickets list

嵌入式终端

web UI包括一个内置终端。点击 终端 在侧边栏中打开一个具有颜色支持和可调整大小的面板的完整PTY外壳。跑 opencode, claude，或直接来自浏览器的任何命令。

Embedded Terminal

代理通过MCP共享相同的SQLite数据库，因此它创建的票会立即显示在您的板上。

数据存储

所有数据都存储在SQLite数据库中：

• macOS: ~/Library/Application Support/taskboard/taskboard.db
• Linux: ~/.config/taskboard/taskboard.db

迁移在首次启动时自动运行。

自定义数据库路径

使用 --db 将任何命令指向其他数据库文件：

taskboard --db /path/to/other.db start
taskboard --db /path/to/other.db mcp
taskboard --db /path/to/other.db ticket list

清除数据

要擦除所有项目、工单、团队和标签，同时保持架构完整，请执行以下操作：

taskboard clear        # prompts for confirmation
taskboard clear -f     # skip confirmation

这也尊重 --db，因此您可以清除特定的数据库文件：

taskboard --db /tmp/test.db clear -f

技术栈

发展

# Run backend (serves API on :3010)
go run ./cmd/taskboard start

# Run frontend dev server (proxies API to :3010)
cd web && npm run dev

# Build everything
make build

# Clean
make clean

贡献

看 贡献.md 作为指导方针。

许可证

麻省理工学院