# Backlog.md

> A CLI-based project management tool that stores tasks as Markdown files directly in your Git repository, enabling backlog tracking without leaving your codebase.

Backlog.md is a lightweight, file-based project management tool that lives entirely inside your Git repository. Tasks are stored as plain Markdown files, making them version-controlled, diff-friendly, and accessible from any editor or terminal. It requires no external services, databases, or accounts — everything stays local and portable with your code.

- **Markdown-native tasks**: *Each task is a `.md` file committed alongside your source code, making it fully version-controlled and reviewable in pull requests.*
- **CLI-first workflow**: *Run `backlog` commands directly from your terminal to create, list, update, and close tasks without switching context.*
- **Zero dependencies on external services**: *No SaaS account, no database, no internet connection required — the backlog lives in your repo.*
- **Git-integrated history**: *Task changes are tracked via Git commits, giving you a full audit trail of who changed what and when.*
- **Editor agnostic**: *Tasks are plain Markdown, so they can be edited in VS Code, Vim, Neovim, or any text editor; Vim/Neovim configuration docs are included.*
- **Portable and self-contained**: *Clone the repo and the entire backlog comes with it — ideal for solo developers and small teams who want simplicity.*
- **Structured task format**: *Tasks support metadata like status, priority, and assignee via frontmatter, keeping information organized without a GUI.*

To get started, install the CLI, navigate to your Git repository, and run `backlog init` to set up the backlog directory. Use `backlog task add "Task title"` to create your first task and `backlog list` to view all open items.

## Features
- Markdown-based task storage
- CLI interface
- Git-integrated version control for tasks
- No external services required
- Vim/Neovim editor support
- Task metadata via frontmatter
- Offline-first workflow
- Portable backlog with repository

## Integrations
Git, Vim, Neovim, VS Code

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Links
- Website: https://github.com/MrLesk/Backlog.md
- Repository: https://github.com/MrLesk/Backlog.md
- EveryDev.ai: https://www.everydev.ai/tools/backlog-md