MrLesk/Backlog.md
MARKDOWN TASK MANAGER FOR AI AGENTS
Backlog.md is a markdown-native task manager and Kanban board for Git repositories. It structures AI agent work through three review checkpoints — spec, plan, and code — so humans can control large-scale code generation.
// KEY FEATURES
- Tasks as .md files in repo with acceptance criteria and Definition of Done
- Three review stages: spec, plan, code — one context window per task
- Terminal Kanban board, web UI with drag-and-drop, and fuzzy search
- Local-first, no server or telemetry; works with Claude Code, Gemini CLI, Codex, MCP
// DEEP DIVE: HOW IT WORKS
Backlog.md initializes in any Git folder and creates a backlog directory with markdown task files. CLI backlog board draws Kanban in terminal, backlog browser serves a web board with drag-and-drop, backlog search provides fuzzy search. Agents get context via CLI or MCP and write specs, plans, and code into these files.
Key difference — no server or DB: tasks are plain files in the repo, suitable for git-diff and review. Built-in milestones, dependencies, and a shared Definition of Done checklist. The project dogfoods itself: nearly all code is written by agents through Backlog.md.
Install via npm, Bun, Homebrew, or Nix (requires Node.js/Bun). Runs on macOS, Linux, Windows. No telemetry, remote Git optional. Agents need their CLIs (Claude Code, Gemini CLI, Codex) or MCP compatibility.
// USE CASES
Best for: Developers and teams delegating code writing to AI agents in Git projects
- Structure AI agent work: from spec through plan to code with review at each stage
- Run a project board in terminal or browser, storing task history in Git as markdown
- Coordinate team of humans and agents via clear acceptance criteria and task dependencies
// QUICK START
npm i -g backlog.md
backlog init "My Awesome Project"
backlog board
npx backlog.md init "My Project"
npx backlog.md boardCommands are taken from the repository README — check the current version on GitHub before running.
New repositories every 30 minutes
REDDYX AI scans GitHub 24/7 and ships the best AI/ML/Web3 projects to Telegram.
Join on Telegram