worktree-init
Creates a git worktree configured for Claude Code agents to work on a bd issue.
Workflow
When asked to spawn a worker or create a worktree for an issue:
- •
Get issue details:
bd show <issue-id> - •
Create branch name from issue type + title slug:
- •bug →
fix/short-description - •feature →
feat/short-description - •task, chore, epic →
chore/short-description
Example: Issue "Add dark mode toggle" (feature) →
feat/dark-mode-toggle - •bug →
- •
Create worktree:
bashworktree-init feat/dark-mode-toggle
- •
Output for user - provide the command to start the worker:
bashcd ../mentorfy-feat/dark-mode-toggle && claude "bd show mt-xyz && work on this issue"
What worktree-init creates
../<project>-<branch> with:
- •Beads redirect (shared issue database)
- •Symlinked
.mcp.json(MCP servers) - •Symlinked
.claude/(settings & skills) - •Copied
.env*files
Cleanup
bash
bd worktree remove ../<worktree-path> --force