johno/beads
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Remove global daemon from docs, deprecate bd repos command

Browse Source 
- Stub out 'bd repos' command with deprecation message
- Remove 140+ lines of global daemon/multi-repo docs from ADVANCED.md
- Add architecture section explaining daemon/MCP/beads roles (LSP model)
- Update AGENTS.md, MCP README, FAQ.md to emphasize per-project daemons
- Update commands/daemon.md and commands/repos.md

Closes #140

Global daemon was removed in v0.16.0 due to cross-project pollution
risks. bd now uses per-project local daemons (one per workspace) for
complete database isolation, following LSP architecture patterns.

Amp-Thread-ID: https://ampcode.com/threads/T-c45147dc-8939-43bf-8fbd-303ed4a8d845
Co-authored-by: Amp <amp@ampcode.com>
This commit is contained in:
Steve Yegge
2025-10-24 13:02:01 -07:00
parent 963181d7f8
commit f5feee0d20
8 changed files with 334 additions and 321 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
commands/repos.md
View File

@@ -1,25 +1,24 @@
---
description: Manage work across multiple repositories
description: DEPRECATED - Multi-repository management
argument-hint: [command]
---
Manage work across multiple repositories when using a global daemon.
**DEPRECATED:** This command is no longer functional.
**Requires**: Running global daemon (`bd daemon --global`)
Global daemon support was removed in v0.16.0. bd now uses per-project local daemons (LSP model) for complete database isolation.
## Available Commands
## Why Was This Removed?
- **list**: List all cached repositories
- **ready**: Show ready work across all repositories
- `--group`: Group results by repository
- **stats**: Show combined statistics across all repositories
- **clear-cache**: Clear all cached repository connections
- Cross-project database pollution risks
- Git worktree conflicts
- Complexity in multi-workspace scenarios
## Usage
## Multi-Repo Workflows Now
- `bd repos list` - See all repositories connected to global daemon
- `bd repos ready` - View all ready work across projects
- `bd repos ready --group` - Group ready work by repository
- `bd repos stats` - Combined statistics from all repos
For working across multiple beads projects:
- Use your editor/shell to switch between project directories
- Each project has its own daemon at `.beads/bd.sock`
- Run `bd ready` in each project individually
- Use single MCP server instance that routes to per-project daemons
Useful for managing multiple beads projects from a single global daemon.
See [ADVANCED.md](../ADVANCED.md#architecture-daemon-vs-mcp-vs-beads) for architecture details.