tuiboard：把 Markdown 待办变成可组合的终端看板
任务管理工具最容易把人困在两种不舒服的选择里：要么使用功能完整却把数据和工作流锁进产品的 SaaS；要么维护几份 Markdown，却只能在编辑器里手动翻列表。真正好用的中间状态，应该是任务仍能作为普通文件被 Git、同步盘或任意编辑器处理，同时在需要专注执行时提供足够快的操作界面。
今天看的是 NazzarenoGiannelli/tuiboard。它是一个基于 Bun、OpenTUI 和 SolidJS 的 terminal kanban：把 CommonMark 文件里的 ## 标题当列、- [ ] 当任务，在终端里显示看板。看板永远存在；Today/Tomorrow planner、24 小时 agenda、Google 或 Microsoft 365 日历叠加、Claude Code session 视图则都是可开可关的区域。它没有要求把待办迁进专有数据库，正是这一点让它特别适合已有笔记仓库或偏好纯文本的人。
按 GitHub repository page、README、LICENSE、latest commit 和 release page 在 2026-09-08 18:03 Asia/Shanghai 能核验的信息，NazzarenoGiannelli/tuiboard 当前有 111 stars、11 forks。主要语言是 TypeScript，license 是 MIT。默认分支为 main，仓库创建于 2026-05-28 16:41:56 UTC，latest push 是 2026-09-08 08:21:10 UTC。最新提交是 82e35de，提交时间 2026-09-08 08:20:54 UTC，提交信息是 release: 0.9.0 — board lifecycle and single-pane mode。GitHub 最新 Release 是 v0.9.0，发布时间 2026-09-08 08:21:11 UTC。
项目概览
| 属性 | 详情 |
|---|---|
| 仓库 | NazzarenoGiannelli/tuiboard |
| 定位 | 基于纯 Markdown 的可组合终端看板 |
| Stars | 111 |
| Forks | 11 |
| 主要语言 | TypeScript |
| 许可证 | MIT |
| 创建时间 | 2026-05-28 16:41:56 UTC |
| Latest push | 2026-09-08 08:21:10 UTC |
| 最新提交 | 82e35de，2026-09-08 08:20:54 UTC |
| 最新 Release | v0.9.0，2026-09-08 08:21:11 UTC |
| 安装方式 | bun install -g tuiboard 或 bunx tuiboard |
| 关键词 | terminal、kanban、Markdown、calendar、Claude Code |
Markdown 是数据格式，不只是导出格式
tuiboard 的基本模型很简单：一个 board 就是一个 .md 文件；二级标题是列，checkbox 行是任务。例如 ## To Do、## In Progress、## Done。它能直接扫描当前目录里包含待办的 Markdown，也可以在 ~/.config/tuiboard/config.yaml 中列出多个 board 的绝对路径。这样一来，任务本身可以继续被 Obsidian、VS Code、Git 或任何同步工具读取和修改。
这不是把 Markdown 当作一次性导入格式，而是把它当作 source of truth。README 还明确兼容 Obsidian Tasks plugin 的 emoji vocabulary；如果你已经有一套文本笔记或 project vault，不需要做一轮数据库迁移才能得到 keyboard-friendly 的看板界面。对经常在编辑器、终端和手机笔记之间切换的人，这比又引入一个孤岛应用更实际。
四个区域，按需要而不是按套餐启用
除看板外，tuiboard 有三个可选区域。planner 会跨多个 board 汇总 Today/Tomorrow；agenda 把时间块放进 24 小时视图，并可只读叠加 Google Calendar 或 Microsoft 365 的事件；agents 则从本机 ~/.claude/ 读取 Claude Code session，显示正在发生的 agent 工作。每个区域可以设为 on、off 或 hidden，关闭后不会启动其背景读取或日历请求。
这个“组合而不是全开”的设计很对终端工具的胃口。只要 kanban，就可以关掉 agenda 和 agents；想在当天排程时再开 calendar；使用 Claude Code 时再把 session 作为背景信息放进界面。需要特别留意 README 的边界：agent 区域只读取 Claude Code 写入的本地 session，Codex 不会显示在那里；日历功能也需要你自己完成 OAuth 或 Azure app 配置。
初次使用足够轻量
项目要求 Bun 1.2 以上，安装可直接执行：
bun install -g tuiboard
tuiboard第一次打开且未配置时，它会进入 onboarding：选择一个目录、采用已有的 Markdown 文件，或者创建新 board。也可以只在一个文件夹里写下最小示例后运行：
## To Do
- [ ] 写第一项任务
## In Progress
## DoneDone 和 Archive 是有特殊语义的列，会在看板主视图中隐藏，但仍用于完成统计与归档操作。这些规则很朴素，却能让一份普通文本清单自然长成可维护的工作面板。
适合谁，以及什么情况下别硬换
它最适合已经把笔记或项目计划放在 Markdown、希望避免 SaaS lock-in、但又不想牺牲终端交互效率的开发者。多个仓库、多个 board 的人在 planner 中看今天和明天，也比在不同文件间来回搜索舒服。日历叠加对于把 coding block 和会议同时排进一天的人也有实际价值。
反过来说，团队协作、复杂权限、移动端原生体验并不是它的主战场。你仍需自行处理 Markdown 文件的共享和冲突；Google/Microsoft 日历也不是零配置。项目目前还很新，建议先拿一两个个人 board 试用，并保留 Git 或同步备份，而不是一开始就把整个团队流程押上去。
总结
tuiboard 的有趣之处不在于再做一个任务应用，而在于选择了一个很克制的分层：Markdown 负责可携带的数据，终端负责快节奏的操作，planner、agenda、calendar 和 agent 视图只在你需要时加入。对于喜欢纯文本、又想把待办从“文件里的列表”变成“手边的工作台”的人，它是一个很轻、也很具体的选项。
项目地址：https://github.com/NazzarenoGiannelli/tuiboard diff —git a/src/content/posts/ja/2026-09-08-tuiboard-markdown-terminal-kanban.md b/src/content/posts/ja/2026-09-08-tuiboard-markdown-terminal-kanban.md new file mode 100644 index 0000000..2222222 --- /dev/null +++ b/src/content/posts/ja/2026-09-08-tuiboard-markdown-terminal-kanban.md