584608a14e
Cherry-picked website/, scripts/generate-llms-full.sh, and deploy-docs.yml from joyshmitz's PR. Fixed workflow to trigger on main branch instead of docs/docusaurus-site. Features: - Docusaurus documentation site with llms.txt support - Environment-variable driven config (defaults to steveyegge org) - Automated llms-full.txt generation from docs - GitHub Pages deployment workflow Co-authored-by: joyshmitz <joyshmitz@users.noreply.github.com> 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> Executed-By: beads/crew/dave Rig: beads Role: crew
1.9 KiB
1.9 KiB
id, title, sidebar_position
| id | title | sidebar_position |
|---|---|---|
| upgrading | Upgrading | 4 |
Upgrading bd
How to upgrade bd and keep your projects in sync.
Checking for Updates
# Current version
bd version
# What's new in recent versions
bd info --whats-new
bd info --whats-new --json # Machine-readable
Upgrading
Homebrew
brew upgrade bd
go install
go install github.com/steveyegge/beads/cmd/bd@latest
From Source
cd beads
git pull
go build -o bd ./cmd/bd
sudo mv bd /usr/local/bin/
After Upgrading
Important: After upgrading, update your hooks and restart daemons:
# 1. Check what changed
bd info --whats-new
# 2. Update git hooks to match new version
bd hooks install
# 3. Restart all daemons
bd daemons killall
# 4. Check for any outdated hooks
bd info # Shows warnings if hooks are outdated
Why update hooks? Git hooks are versioned with bd. Outdated hooks may miss new auto-sync features or bug fixes.
Database Migrations
After major upgrades, check for database migrations:
# Inspect migration plan (AI agents)
bd migrate --inspect --json
# Preview migration changes
bd migrate --dry-run
# Apply migrations
bd migrate
# Migrate and clean up old files
bd migrate --cleanup --yes
Daemon Version Mismatches
If you see daemon version mismatch warnings:
# List all running daemons
bd daemons list --json
# Check for version mismatches
bd daemons health --json
# Restart all daemons with new version
bd daemons killall --json
Troubleshooting Upgrades
Old daemon still running
bd daemons killall
Hooks out of date
bd hooks install
Database schema changed
bd migrate --dry-run
bd migrate
Import errors after upgrade
Check the import configuration:
bd config get import.orphan_handling
bd import -i .beads/issues.jsonl --orphan-handling allow