docs: update daemon CLI syntax from flags to subcommands
Update all documentation to use the new subcommand syntax: - `bd daemon --start` → `bd daemon start` - `bd daemon --stop` → `bd daemon stop` - `bd daemon --status` → `bd daemon status` - `bd daemon --health` → `bd daemon status --all` - `--global=false` → `--local` The old flag syntax is deprecated but still works with warnings. Closes: bd-734vd Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
committed by
Steve Yegge
parent
669ea40684
commit
d1722d9204
@@ -1,6 +1,6 @@
|
||||
---
|
||||
description: Manage background sync daemon
|
||||
argument-hint: [start] [stop] [status] [--health]
|
||||
argument-hint: [start] [stop] [status]
|
||||
---
|
||||
|
||||
Manage the per-project background daemon that handles database connections and syncs with git.
|
||||
@@ -42,7 +42,7 @@ Each project runs its own daemon at `.beads/bd.sock` for complete database isola
|
||||
- **Start**: `bd daemon start` (or auto-starts on first `bd` command)
|
||||
- **Stop**: `bd daemon stop`
|
||||
- **Status**: `bd daemon status`
|
||||
- **Health**: `bd daemon --health` - shows uptime, cache stats, performance metrics
|
||||
- **Health**: `bd daemon status --all` - shows uptime, cache stats, performance metrics
|
||||
- **Metrics**: `bd daemon --metrics` - detailed operational telemetry
|
||||
|
||||
## Sync Options
|
||||
|
||||
@@ -64,7 +64,7 @@ go install github.com/steveyegge/beads/cmd/bd@latest
|
||||
**3. Restart daemon after upgrade:**
|
||||
```bash
|
||||
pkill -f "bd daemon" # Kill old daemon
|
||||
bd daemon # Start new daemon with fix
|
||||
bd daemon start # Start new daemon with fix
|
||||
```
|
||||
|
||||
**4. Test dependency creation:**
|
||||
@@ -172,7 +172,7 @@ bd show issue-1
|
||||
|
||||
### Symptom
|
||||
```bash
|
||||
bd daemon
|
||||
bd daemon start
|
||||
# Error: not in a git repository
|
||||
# Hint: run 'git init' to initialize a repository
|
||||
```
|
||||
@@ -189,19 +189,19 @@ bd daemon requires a **git repository** because it uses git for:
|
||||
```bash
|
||||
# In your project directory
|
||||
git init
|
||||
bd daemon
|
||||
bd daemon start
|
||||
# ✓ Daemon should start now
|
||||
```
|
||||
|
||||
**Prevent git remote operations:**
|
||||
**Run in local-only mode (no git required):**
|
||||
```bash
|
||||
# If you don't want daemon to pull from remote
|
||||
bd daemon --global=false
|
||||
# If you don't want daemon to use git at all
|
||||
bd daemon start --local
|
||||
```
|
||||
|
||||
**Flags:**
|
||||
- `--global=false`: Don't sync with git remote
|
||||
- `--interval=10m`: Custom sync interval (default: 5m)
|
||||
- `--local`: Run in local-only mode (no git required, no sync)
|
||||
- `--interval=10m`: Custom sync interval (default: 5s)
|
||||
- `--auto-commit=true`: Auto-commit JSONL changes
|
||||
|
||||
---
|
||||
@@ -295,7 +295,7 @@ ls .beads/
|
||||
|
||||
**Start daemon once to initialize JSONL:**
|
||||
```bash
|
||||
bd daemon --global=false &
|
||||
bd daemon start --local &
|
||||
# Wait for initialization
|
||||
sleep 2
|
||||
|
||||
@@ -320,7 +320,7 @@ cat .beads/issues.jsonl
|
||||
# Batch import script
|
||||
|
||||
bd init myproject
|
||||
bd daemon --global=false & # Start daemon
|
||||
bd daemon start --local & # Start daemon
|
||||
sleep 3 # Wait for initialization
|
||||
|
||||
# Now safe to use --no-daemon for performance
|
||||
@@ -476,7 +476,7 @@ If the **bd-issue-tracking skill** provides incorrect guidance:
|
||||
| Status updates lag | Use daemon mode (not `--no-daemon`) |
|
||||
| Daemon won't start | Run `git init` first |
|
||||
| Database errors on Google Drive | Move to local filesystem |
|
||||
| JSONL file missing | Start daemon once: `bd daemon &` |
|
||||
| JSONL file missing | Start daemon once: `bd daemon start &` |
|
||||
| Dependencies backwards (MCP) | Update to v0.15.0+, use `issue_id/depends_on_id` correctly |
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user