beans
A CLI-based, flat-file issue tracker for humans and robots. 🤖
Beans is a CLI-based, flat-file issue tracker that integrates with AI coding agents through Claude Code plugin hooks and other agent platforms. It stores tasks, bugs, and feature requests as Markdown files in a .beans directory within your project repository, allowing both humans and AI assistants to manage work items collaboratively. The plugin includes a built-in GraphQL query engine that enables coding agents to retrieve project context efficiently, turning them into autonomous project managers that can suggest tasks, track progress, and create issues. Completed tasks are archived to serve as project memory for future AI-assisted development sessions.
Key Features
Use Cases
- 01Enabling AI coding agents to autonomously track and manage project tasks alongside code changes
- 02Maintaining a version-controlled issue tracker that lives within the project repository
- 03Letting coding assistants create bug reports when they discover problems during development
- 04Having AI agents recommend and prioritize next tasks based on project context
- 05Building project memory by archiving completed work that agents can query for historical context
- 06Organizing tasks into epics and milestones through natural language instructions to AI assistants
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
beans — FAQ
What is the Beans Claude Code plugin?+
Beans is a flat-file issue tracker that integrates with Claude Code and other AI coding agents, enabling them to manage tasks, bugs, and features stored as Markdown files directly in your project repository. It gives coding agents full visibility into project tasks and allows them to autonomously track progress.
How do I install Beans for Claude Code?+
First install the beans CLI via Homebrew (brew install hmans/beans/beans), download from GitHub releases, or use go install. Then run 'beans init' in your project root and add SessionStart and PreCompact hooks to your .claude/settings.json file that execute the 'beans prime' command.
Which AI coding clients work with Beans?+
Beans officially supports Claude Code through plugin hooks and OpenCode via a TypeScript plugin. It can also work with any coding agent that can execute CLI commands and read instruction files like AGENTS.md or CLAUDE.md.
Does Beans require API keys or external services?+
No, Beans is entirely local and stores all task data as Markdown files in your project's .beans directory. It requires no API keys, external services, or cloud dependencies.
Is Beans free and open source?+
Yes, Beans is licensed under the Apache-2.0 License and is available as open source software on GitHub.
What are the prerequisites for using Beans?+
You need the beans CLI tool installed (available via Homebrew, GitHub releases, or Go install) and a coding agent that supports executing commands or custom hooks, such as Claude Code or OpenCode.
How do I install beans?+
Open the source repository on GitHub and follow its README. beans is a plugin — MCP Agents Market links you directly to the official repo.
Is beans free?+
beans is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.