beans - Flat-File Issue Tracker

A lightweight, flat-file issue tracker for humans and AI coding agents. Stores issues as markdown files in .beans/ directory alongside your code.

IMPORTANT: before you do anything else, run the beans prime command and heed its output, but also heed the exceptions at "When to create beans".

Why beans?

• Simple — No database, no server, just markdown files
• AI-friendly — Designed for AI coding agents
• Git-friendly — Lives alongside your code in .beans/
• Portable — Works with any editor/IDE

Installation

# Via Homebrew
brew install hmans/beans/beans