beads/docs
Steve Yegge 2560b11f80 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>
2025-11-24 00:03:07 -08:00
..
adr feat(agent-mail): Add Python adapter library for Agent Mail integration 2025-11-08 00:15:07 -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
ARCHITECTURE.md Fix race condition in auto-flush mechanism (issue bd-52) 2025-11-20 21:24:31 -05: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 chore: Move design/audit docs from cmd/bd to docs/ 2025-11-21 20:31:47 -05:00
CLI_REFERENCE.md feat: Complete GH #353 follow-up phases (bd-9nw, bd-u3t, bd-e0o) 2025-11-21 19:32:45 -05:00
COLLISION_MATH.md Remove obsolete collision remapping code and tests 2025-10-31 00:19:42 -07:00
CONFIG.md Increase daemon log rotation limits for production use 2025-11-23 21:33:00 -08:00
DAEMON.md feat: Add --start flag to bd daemon, show help with no args 2025-11-24 00:03:07 -08:00
ERROR_HANDLING.md Add comprehensive error handling guidelines documentation 2025-11-23 21:54:08 -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 fix: Correct git merge driver placeholders from %L/%R to %A/%B 2025-11-21 20:40:18 -05:00
INSTALLING.md Add uv prerequisite to Claude Code plugin documentation (#293) 2025-11-12 10:49:38 -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
MAIN_TEST_CLEANUP_PLAN.md refactor: Delete 7 redundant tests from main_test.go (3x speedup) 2025-11-21 21:29:43 -05:00
MAIN_TEST_REFACTOR_NOTES.md refactor: Delete 7 redundant tests from main_test.go (3x speedup) 2025-11-21 21:29:43 -05: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
PLUGIN.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
PROTECTED_BRANCHES.md Document which files to commit after bd init --branch 2025-11-20 21:47:50 -05:00
QUICKSTART.md Fix #349: Improve compact error messages, remove bogus merge suggestion, add daemon/maintenance docs 2025-11-20 20:58:57 -05: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
TEST_SUITE_AUDIT.md chore: Move design/audit docs from cmd/bd to docs/ 2025-11-21 20:31:47 -05:00
TESTING.md feat: Add test infrastructure with automatic skip list 2025-11-21 22:43:04 -05:00
TROUBLESHOOTING.md feat: Complete GH #353 follow-up phases (bd-9nw, bd-u3t, bd-e0o) 2025-11-21 19:32:45 -05:00