import{_ as a,c as i,o as e,a0 as t}from"./chunks/framework.FdfEk_gD.js";const c=JSON.parse('{"title":"Beads Integration for Workflows Server","description":"","frontmatter":{},"headers":[],"relativePath":"user/beads-integration.md","filePath":"user/beads-integration.md"}'),n={name:"user/beads-integration.md"};function l(r,s,o,h,p,d){return e(),i("div",null,[...s[0]||(s[0]=[t(`<h1 id="beads-integration-for-workflows-server" tabindex="-1">Beads Integration for Workflows Server <a class="header-anchor" href="#beads-integration-for-workflows-server" aria-label="Permalink to &quot;Beads Integration for Workflows Server&quot;">​</a></h1><p>Integration between the workflows server and <a href="https://github.com/steveyegge/beads" target="_blank" rel="noreferrer">beads distributed issue tracker</a> for enhanced AI agent task management.</p><h2 id="overview" tabindex="-1">Overview <a class="header-anchor" href="#overview" aria-label="Permalink to &quot;Overview&quot;">​</a></h2><p><strong>Prerequisites</strong>: <code>bd</code> CLI must be installed and available in PATH.</p><p><strong>Backends</strong>:</p><ul><li><strong>Markdown</strong>: Checkbox tasks in plan files</li><li><strong>Beads</strong>: Rich task management with dependencies, priorities, and git integration</li></ul><h2 id="configuration" tabindex="-1">Configuration <a class="header-anchor" href="#configuration" aria-label="Permalink to &quot;Configuration&quot;">​</a></h2><p>Beads is <strong>auto-detected</strong>: if the <code>bd</code> command is available, it is used automatically. No configuration needed.</p><p>To explicitly override auto-detection:</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> TASK_BACKEND</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">markdown  </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Force markdown even if bd is available</span></span>
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> TASK_BACKEND</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">beads     </span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Force beads (errors if bd unavailable)</span></span></code></pre></div><h2 id="quick-setup" tabindex="-1">Quick Setup <a class="header-anchor" href="#quick-setup" aria-label="Permalink to &quot;Quick Setup&quot;">​</a></h2><ol><li>Install beads CLI (<code>bd</code> command must be in PATH)</li><li>Use <code>start_development()</code> as normal — beads is detected automatically</li></ol><h2 id="usage" tabindex="-1">Usage <a class="header-anchor" href="#usage" aria-label="Permalink to &quot;Usage&quot;">​</a></h2><h3 id="development-workflow" tabindex="-1">Development Workflow <a class="header-anchor" href="#development-workflow" aria-label="Permalink to &quot;Development Workflow&quot;">​</a></h3><p>When beads is active:</p><ol><li><strong>Project epic</strong>: Created automatically for all development tasks</li><li><strong>Phase tasks</strong>: One task per workflow phase with sequential dependencies</li><li><strong>Plan file</strong>: Modified to include beads task IDs in comments</li></ol><p><strong>Task Hierarchy</strong> (automatic):</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>Project Epic: &quot;responsible-vibe Development: My Project&quot; (bd-a1b2)</span></span>
<span class="line"><span>├── Explore Phase (bd-a1b2.1) → Plan Phase (bd-a1b2.2) →</span></span>
<span class="line"><span>├── Code Phase (bd-a1b2.3) → Commit Phase (bd-a1b2.4)</span></span></code></pre></div><p><strong>Sequential dependencies</strong>: Each phase blocks the next, ensuring proper workflow order.</p><h3 id="essential-commands" tabindex="-1">Essential Commands <a class="header-anchor" href="#essential-commands" aria-label="Permalink to &quot;Essential Commands&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Task creation with context</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> create</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Task title&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --parent</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.1</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --description</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;what, why, how&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --priority</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 2</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Task management</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --parent</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2.1</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --status</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> open</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # List phase tasks</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> show</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">task-i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">                          # Show details</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">task-i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --status</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> in_progress</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">   # Update status</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> close</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">task-i</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">d</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">                         # Mark complete</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Project overview</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> show</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">                            # Show epic</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bd</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --parent</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bd-a1b2</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --recursive</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">       # All project tasks</span></span></code></pre></div><h2 id="troubleshooting" tabindex="-1">Troubleshooting <a class="header-anchor" href="#troubleshooting" aria-label="Permalink to &quot;Troubleshooting&quot;">​</a></h2><p><strong><code>bd</code> command not found</strong>: Install beads CLI and ensure it&#39;s in PATH<br><strong>Beads setup failed</strong>: Ensure git repo, run <code>bd init</code> if needed<br><strong>Phase task IDs missing</strong>: Re-run <code>start_development()</code> to regenerate beads integration</p><p><strong>Switch backends</strong>: Set <code>TASK_BACKEND=markdown</code> to disable beads, or unset it to re-enable auto-detection.</p><h2 id="technical-notes" tabindex="-1">Technical Notes <a class="header-anchor" href="#technical-notes" aria-label="Permalink to &quot;Technical Notes&quot;">​</a></h2><ul><li><strong>Backwards compatible</strong>: Existing markdown projects unaffected</li><li><strong>Per-project choice</strong>: Each project chooses its backend independently</li><li><strong>Graceful fallback</strong>: Falls back to markdown if beads unavailable</li><li><strong>Plan file modifications</strong>: Phase task IDs stored in comments for reference</li></ul><p><strong>Limitations</strong>: No real-time sync between beads and plan files; manual task creation required.</p><h2 id="resources" tabindex="-1">Resources <a class="header-anchor" href="#resources" aria-label="Permalink to &quot;Resources&quot;">​</a></h2><ul><li><a href="https://github.com/steveyegge/beads" target="_blank" rel="noreferrer">Beads Repository</a></li><li><a href="https://github.com/beads-data/beads/tree/main/integrations/beads-mcp" target="_blank" rel="noreferrer">Beads MCP Integration</a></li></ul>`,29)])])}const g=a(n,[["render",l]]);export{c as __pageData,g as default};
