website/versioned_docs/version-1.0.0/reference/troubleshooting.md
Common issues and solutions.
bd: command not found# Check if installed
which bd
go list -f {{.Target}} github.com/steveyegge/beads/cmd/bd
# Add Go bin to PATH
export PATH="$PATH:$(go env GOPATH)/bin"
# Or reinstall
go install github.com/steveyegge/beads/cmd/bd@latest
zsh: killed bd on macOSCGO/SQLite compatibility issue:
CGO_ENABLED=1 go install github.com/steveyegge/beads/cmd/bd@latest
chmod +x $(which bd)
# Initialize beads
bd init --quiet
# Or specify database
bd --db .beads/beads.db list
# Stop the Dolt server if running
bd dolt stop
# Try again
bd list
# Check and fix database
bd doctor --fix
# Or pull from Dolt remote
bd dolt pull
# Or restore from a backup
bd backup restore [path] --force
# Check server health
bd doctor
# Check server logs
cat .beads/dolt/sql-server.log
# Restart the server
bd dolt stop
bd dolt start
After upgrading bd:
bd dolt stop
bd dolt start
# Force push to Dolt remote
bd dolt push
# Check hooks
bd hooks status
# Restore from a Dolt backup
bd backup restore [path] --force
# Or pull from Dolt remote
bd dolt pull
# Check for and fix Dolt conflicts
bd doctor --fix
# Re-push
bd dolt push
# Check if installed
ls -la .git/hooks/
# Reinstall
bd hooks install
# Check hook script
cat .git/hooks/pre-commit
# Run manually
.git/hooks/pre-commit
# Detect cycles
bd dep cycles
# Remove one dependency
bd dep remove bd-A bd-B
# Check orphan handling
bd config get import.orphan_handling
# Allow orphans
bd config set import.orphan_handling allow
# Check database size
ls -lh .beads/beads.db
# Compact if large
bd admin compact --analyze
# Reduce cache
bd config set database.cache_size 1000
bd --verbose list
cat .beads/dolt/sql-server.log
bd info --json
# Include this info
bd version
bd info --json
uname -a
Report at: https://github.com/gastownhall/beads/issues