feat: Add --start flag to bd daemon, show help with no args

Currently 'bd daemon' with no args immediately starts the daemon. This is
inconsistent with other daemon management commands like --stop, --status,
etc. and makes the command less discoverable for new users.

Changes:
- Add --start flag to explicitly start daemon
- Show help text when no operation flags provided
- Update auto-start logic to use --start flag
- Update startDaemon() to pass --start when forking
- Update all documentation to use 'bd daemon --start'
- Update MCP Python client error messages

The MCP docs already incorrectly showed 'bd daemon start' which doesn't
work, so this change fixes that documentation bug while improving UX.

Auto-start still works correctly - it now passes --start internally.

Fixes bd-gfu

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-11-24 00:03:07 -08:00
parent 95b1577521
commit 2560b11f80
9 changed files with 47 additions and 26 deletions

View File

@@ -28,7 +28,7 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
In your beads project directory:
```bash
bd daemon start
bd daemon --start
```
The daemon will:
@@ -108,19 +108,19 @@ If you want to temporarily use CLI mode:
```bash
# Start daemon
bd daemon start
bd daemon --start
# Check status
bd daemon status
bd daemon --status
# View logs
bd daemon logs
bd daemons logs .
# Stop daemon
bd daemon stop
bd daemon --stop
# Restart daemon
bd daemon stop && bd daemon start
bd daemon --stop && bd daemon --start
```
## Troubleshooting
@@ -130,7 +130,7 @@ bd daemon stop && bd daemon start
Start the daemon in your beads project:
```bash
cd ~/src/vc/adar/beads
bd daemon start
bd daemon --start
```
### Wrong database being used

View File

@@ -110,7 +110,7 @@ class BdDaemonClient(BdClientBase):
# No socket found anywhere
raise DaemonNotRunningError(
"Daemon socket not found. Is the daemon running? Try: bd daemon (local) or bd daemon --global"
"Daemon socket not found. Is the daemon running? Try: bd daemon --start"
)
async def _send_request(self, operation: str, args: Dict[str, Any]) -> Any: