beads/docs
matt wilkie e01b7412d9 feat: add Git worktree compatibility (PR #478)
Adds comprehensive Git worktree support for beads issue tracking:

Core changes:
- New internal/git/gitdir.go package for worktree detection
- GetGitDir() returns proper .git location (main repo, not worktree)
- Updated all hooks to use git.GetGitDir() instead of local helper
- BeadsDir() now prioritizes main repository's .beads directory

Features:
- Hooks auto-install in main repo when run from worktree
- Shared .beads directory across all worktrees
- Config option no-install-hooks to disable auto-install
- New bd worktree subcommand for diagnostics

Documentation:
- New docs/WORKTREES.md with setup instructions
- Updated CHANGELOG.md and AGENT_INSTRUCTIONS.md

Testing:
- Updated tests to use exported git.GetGitDir()
- Added worktree detection tests

Co-authored-by: Claude <noreply@anthropic.com>
Closes: #478
2025-12-13 12:50:33 -08:00
..
adr feat(agent-mail): Add Python adapter library for Agent Mail integration 2025-11-08 00:15:07 -08:00
dev-notes chore: clean up root directory cruft 2025-12-05 15:57:56 -08:00
ADAPTIVE_IDS.md Implement adaptive ID length scaling (bd-ea2a13) 2025-10-30 21:40:52 -07:00
ADVANCED.md Fix #264 and #262: Remove stale --resolve-collisions references 2025-11-08 13:18:50 -08:00
AGENT_MAIL.md docs: Add comprehensive Agent Mail integration guide 2025-11-08 00:49:41 -08:00
AGENT_MAIL_DEPLOYMENT.md Add Agent Mail multi-workspace deployment guide and scripts 2025-11-08 04:16:44 -08:00
AGENT_MAIL_MULTI_WORKSPACE_SETUP.md Add Agent Mail multi-workspace deployment guide and scripts 2025-11-08 04:16:44 -08:00
AGENT_MAIL_QUICKSTART.md Complete Agent Mail documentation (bd-nl8z) 2025-11-08 02:36:27 -08:00
AIDER_INTEGRATION.md Add Aider integration for beads issue tracking 2025-11-23 15:13:54 -08:00
ANTIVIRUS.md docs: Add antivirus false positive documentation (bd-t4u1) 2025-11-24 01:04:40 -08:00
ARCHITECTURE.md bd sync: 2025-11-25 11:35:26 2025-11-25 11:35:26 -08:00
ATTRIBUTION.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
CLAUDE.md Fix #264 and #262: Remove stale --resolve-collisions references 2025-11-08 13:18:50 -08:00
CLAUDE_INTEGRATION.md bd sync: 2025-11-26 18:07:01 2025-11-26 18:07:01 -08:00
CLI_REFERENCE.md docs: Complete import.orphan_handling documentation (bd-9cdc) 2025-11-24 01:08:08 -08:00
COLLISION_MATH.md Remove obsolete collision remapping code and tests 2025-10-31 00:19:42 -07:00
CONFIG.md feat: add Git worktree compatibility (PR #478) 2025-12-13 12:50:33 -08:00
DAEMON.md docs(UX): improve daemon and merge documentation (bd-bt6y) 2025-11-28 23:11:24 -08:00
DELETIONS.md docs: update deletion docs for tombstones, add changelog entries 2025-12-13 07:28:38 -08:00
ERROR_HANDLING.md docs: Complete error handling audit 2025-11-24 00:35:04 -08:00
EXCLUSIVE_LOCK.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
EXTENDING.md Fix SQLite driver name mismatch causing "unknown driver" errors (#252) 2025-11-07 14:19:14 -08:00
FAQ.md Fix #264 and #262: Remove stale --resolve-collisions references 2025-11-08 13:18:50 -08:00
GIT_INTEGRATION.md feat: add Git worktree compatibility (PR #478) 2025-12-13 12:50:33 -08:00
INSTALLING.md feat: add Git worktree compatibility (PR #478) 2025-12-13 12:50:33 -08:00
INTERNALS.md bd sync: 2025-11-25 11:35:26 2025-11-25 11:35:26 -08:00
LABELS.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
LINTING.md Document -short flag, update linting baseline, clarify bd edit MCP exclusion 2025-11-06 19:42:01 -08:00
MULTI_REPO_AGENTS.md Add multi-repo patterns documentation for AI agents (bd-4b6u) 2025-11-06 19:53:29 -08:00
MULTI_REPO_HYDRATION.md Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
MULTI_REPO_MIGRATION.md feat: Add bd init --contributor and --team wizards 2025-11-05 19:04:14 -08:00
PERFORMANCE_TESTING.md docs: add performance testing guide (bd-zj8e) 2025-11-28 23:26:24 -08:00
PLUGIN.md feat: add Git worktree compatibility (PR #478) 2025-12-13 12:50:33 -08:00
PROTECTED_BRANCHES.md feat: add Git worktree compatibility (PR #478) 2025-12-13 12:50:33 -08:00
QUICKSTART.md docs(UX): improve daemon and merge documentation (bd-bt6y) 2025-11-28 23:11:24 -08:00
README_TESTING.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
RELEASING.md Fix RELEASING.md: Homebrew formula uses GoReleaser artifacts, not source tarball 2025-11-08 03:59:59 -08:00
ROUTING.md Add routing integration tests and documentation 2025-11-04 23:12:42 -08:00
TESTING.md feat: Add test infrastructure with automatic skip list 2025-11-21 22:43:04 -05:00
TROUBLESHOOTING.md docs: Complete import.orphan_handling documentation (bd-9cdc) 2025-11-24 01:08:08 -08:00
UNINSTALLING.md Add uninstall documentation (GH #445) 2025-12-01 21:05:19 -08:00
WORKTREES.md feat: add Git worktree compatibility (PR #478) 2025-12-13 12:50:33 -08:00