My coding agents don't need a project management tool. They need markdown files.
说明与用途
编码代理不需要付费的任务跟踪器,它们需要Markdown文件。使用board.md,它们可以直接在仓库中读取和更新状态,避免API调用和计划限制。
问题
Agents required a task tracker that was costly and limited; they only needed simple file-based tasks.
结果
Agents can now read and edit tasks directly in the repo, eliminating API costs and simplifying status updates; board.md provides a lightweight kanban view.
工作流
- Create markdown task files with YAML frontmatter
- Run
npx boardmd initto generate config - Run
npx boardmd serve --opento view board - Drag card to change status, which updates one line in file
- Agents use boardmd commands to list, create, set, and check tasks
证据
An agent needs a file it can read and edit. One markdown file per task, in the repo, with the fields in YAML frontmatter and the notes below:
board.md reads the files you have. npx boardmd init looks at them and works out a config: the id format, the statuses, which fields become badges or filters.
When I drag a card, exactly one line of one file changes: -status: todo +status: in-progress
boardmd list --json: Every open task with its fields, its file and its live state from git.
- 记录日期: 2026-10-10T04:11:16.696Z