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 init to generate config
• Run npx boardmd serve --open to 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.

Источник