issue.md

Track issues in plain Markdown.

issue.md is a file-first issue system powered by a CLI. Keep issue data human readable, versionable, and easy to review in pull requests.

Git-native workflow

Issues live in your repository, so updates naturally flow through commits and code review.

Readable by humans

Every issue and comment is plain Markdown with structured frontmatter for automation.

Built for automation

Stable schemas and CLI commands make CI validation and team tooling straightforward.

Quick start

Create an issue and list everything from your terminal.

npm run cli -- issue create --title "Add website docs" --repo issues
npm run cli -- issue list --repo issues