{
  "markdown": "# Gemini Beads Extension\n\nThis is a [Gemini CLI](https://github.com/google/gemini-cli) extension for **[Beads (`bd`)](https://github.com/steveyegge/beads)**, a graph-based issue tracker that provides persistent memory for multi-session work, backed by Git.\n\n## Description\n\nThe 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.\n\n**Features:**\n- **Persistent Memory:** Track work across multiple AI sessions.\n- **Dependency Management:** Handle blocked tasks and prerequisites.\n- **Git Integration:** Issues and state are stored in your git repository.\n- **Context Awareness:** Provides AI-optimized context about the project and current tasks.\n\n## Prerequisites\n\nThis extension requires the **Beads (`bd`)** CLI tool to be installed and available in your system's PATH.\n\n*(Note: Ensure you have the `bd` executable installed on your machine.)*\n\n## Installation\n\nTo install this extension with Gemini CLI:\n\n```bash\ngemini extension install https://github.com/thoreinstein/gemini-beads\n```\n\n## Usage\n\nOnce 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.\n\n### Common Commands\n\n- `/beads:prime`: Load project context (run this when starting a session).\n- `/beads:ready`: Find unblocked work to do.\n- `/beads:create`: Create a new issue/bead.\n- `/beads:list`: List issues.\n- `/beads:show`: Show details of a specific issue.\n- `/beads:update`: Update an issue's status or properties.\n- `/beads:close`: Close an issue.\n- `/beads:sync`: Sync changes to git.\n\n### Full Command List\n\nThe extension maps the following `bd` commands:\n\n- `audit`\n- `blocked`\n- `close`\n- `comments`\n- `compact`\n- `create`\n- `daemon` / `daemons`\n- `delete`\n- `dep` (dependencies)\n- `epic`\n- `export` / `import`\n- `init`\n- `label`\n- `list`\n- `prime`\n- `quickstart`\n- `ready`\n- `rename-prefix`\n- `reopen`\n- `restore`\n- `search`\n- `show`\n- `stats`\n- `sync`\n- `template`\n- `update`\n- `version`\n- `workflow`\n\n## AI Context\n\nThis extension includes a `GEMINI.md` file that provides specific instructions to the Gemini agent on how to:\n1.  **Start** a session (check for unblocked work).\n2.  **Contextualize** (read task details).\n3.  **Work** (update status).\n4.  **Finish** (close tasks).\n5.  **Save** (sync to git).\n\n## License\n\nMIT\n",
  "bytes": 2535,
  "sha": "e4cbd16fd7bc86eb8392f4922c7825abb23a2d93fbf7009a34eb76baab9e2225",
  "repo_slug": "thoreinstein/gemini-beads",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_thoreinstein_gemini_beads_d96d40fe/readme"
}