This is a Gemini CLI extension for Beads (bd), a graph-based issue tracker that provides persistent memory for multi-session work, backed by Git.
The Gemini Beads extension allows you to manage tasks, issues, and project context directly from your Gemini CLI session. It wraps the bd command-line tool, enabling an AI-native workflow for managing complex, multi-session development tasks.
Features:
- Persistent Memory: Track work across multiple AI sessions.
- Dependency Management: Handle blocked tasks and prerequisites.
- Git Integration: Issues and state are stored in your git repository.
- Context Awareness: Provides AI-optimized context about the project and current tasks.
This extension requires the Beads (bd) CLI tool to be installed and available in your system's PATH.
(Note: Ensure you have the bd executable installed on your machine.)
To install this extension with Gemini CLI:
gemini extension install https://github.com/thoreinstein/gemini-beadsOnce installed, the bd commands are available within Gemini. The extension also provides the GEMINI.md context file, which instructs Gemini on how to effectively use Beads to manage your project.
/beads:prime: Load project context (run this when starting a session)./beads:ready: Find unblocked work to do./beads:create: Create a new issue/bead./beads:list: List issues./beads:show: Show details of a specific issue./beads:update: Update an issue's status or properties./beads:close: Close an issue./beads:sync: Sync changes to git.
The extension maps the following bd commands:
auditblockedclosecommentscompactcreatedaemon/daemonsdeletedep(dependencies)epicexport/importinitlabellistprimequickstartreadyrename-prefixreopenrestoresearchshowstatssynctemplateupdateversionworkflow
This extension includes a GEMINI.md file that provides specific instructions to the Gemini agent on how to:
- Start a session (check for unblocked work).
- Contextualize (read task details).
- Work (update status).
- Finish (close tasks).
- Save (sync to git).
MIT