* feat(docs): version Docusaurus site and align llms-full with snapshots Add docs version 1.0.0, version dropdown, lastVersion defaulting to stable, merged markdown config, and RELEASING steps for future doc snapshots. generate-llms-full.sh reads the latest entry in versions.json. README links the published documentation site. Closes #2644 Made-with: Cursor * fix(docs): update org URLs to gastownhall and refresh 1.0.0 snapshot - Update default orgName in docusaurus.config.ts from steveyegge to gastownhall to match the repo's new home - Update hardcoded steveyegge URLs in generate-llms-full.sh - Refresh versioned_docs 1.0.0 snapshot to include quickstart changes from #3032 which merged after the original snapshot was taken - Regenerate llms-full.txt with corrected URLs and updated content Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: matt wilkie <maphew@gmail.com> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1.8 KiB
1.8 KiB
| id | title | sidebar_position |
|---|---|---|
| aider | Aider | 3 |
Aider Integration
How to use beads with Aider.
Setup
Quick Setup
bd setup aider
This creates/updates .aider.conf.yml with beads context.
Verify Setup
bd setup aider --check
Configuration
The setup adds to .aider.conf.yml:
# Beads integration — bd prime provides issue context
auto-commits: false
Workflow
Start Session
# Aider will have access to issues via .aider.conf.yml
aider
# Or manually inject context
bd prime | aider --message-file -
During Work
Use bd commands alongside aider:
# In another terminal or after exiting aider
bd create "Found bug during work" --deps discovered-from:bd-42 --json
bd update bd-42 --claim
bd ready
End Session
bd dolt push
Best Practices
- Keep issues visible - Use
bd primeto inject issue context - Push regularly - Run
bd dolt pushafter significant changes - Use discovered-from - Track issues found during work
- Document context - Include descriptions in issues
Example Workflow
# 1. Check ready work
bd ready
# 2. Start aider with issue context
aider --message "Working on bd-42: Fix auth bug"
# 3. Work in aider...
# 4. Create discovered issues
bd create "Found related bug" --deps discovered-from:bd-42 --json
# 5. Complete and push
bd close bd-42 --reason "Fixed"
bd dolt push
Troubleshooting
Config not loading
# Check config exists
cat .aider.conf.yml
# Regenerate
bd setup aider
Issues not visible
# Use bd prime to inject issue context
bd prime | aider --message-file -
# Or check database health
bd doctor