beads-issue-tracker

Manage project issues as text files in a .beads folder via CLI commands.

1|1|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/code0100fun/botfiles --skill beads-issue-tracker-code0100fun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-issue-tracker
Source: https://github.com/code0100fun/botfiles/tree/main/plugins/workflow-tools/skills/beads-issue-tracker
Command: npx skills add https://github.com/code0100fun/botfiles --skill beads-issue-tracker-code0100fun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Beads provides a local-first issue tracker that stores issues as plain text in a .beads directory, enabling offline work and seamless git-based collaboration for project issues.

Core Features & Use Cases

  • Local file-based issue storage with standard CLI workflows for creating, listing, updating, and closing issues.
  • Supports status tracking, labels, and basic workflows, useful for managing work across sessions and across teams using Git.
  • Use Case: A solo developer or small team can track bugs, tasks, and features without a centralized server, keeping everything in your repository.

Quick Start

Create your first beads issue with a descriptive title to begin tracking locally.

Frequently Asked Questions about beads-issue-tracker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track issues locally in a git repository?

Local issue tracking stores issues as plain text files in a dedicated .beads directory within your git repository. This allows you to manage bugs, tasks, and features offline while keeping everything synced via standard Git workflows.

What is local-first issue tracking and how does it work with git?

Local-first issue tracking stores issues as text files in a .beads directory, keeping them directly in your repository. It works with Git by syncing issue updates through standard commits, enabling seamless offline collaboration for solo developers and small teams.

Can I manage project issues offline without a centralized server?

Yes, you can manage project issues entirely offline without a centralized server. Issues are stored as local text files in a .beads directory, allowing solo developers and small teams to create, update, and close tasks directly via CLI commands.

How do I create and update local issues from the command line?

You can create and update local issues using CLI commands to create, list, show, update, close, comment, and search entries. These commands handle status tracking, labels, and comments, storing all changes locally as text files in the .beads directory.

Does offline issue tracking support labels, status updates, and comments?

Yes, offline issue tracking supports applying labels, updating issue statuses, and adding comments. These actions are handled via CLI commands, allowing you to manage work across sessions with all metadata stored locally as text files in the .beads directory.

What are the limitations of file-based issue tracking for small teams?

File-based issue tracking lacks centralized server features like real-time synchronization and web-based visual dashboards. It is best suited for solo developers or small teams who prefer offline work and are comfortable managing project issues strictly through local text files and Git workflows.