Add Agent Mail documentation and bash-agent integration

- Added Agent Mail section to QUICKSTART.md with benefits and setup
- Integrated Agent Mail into bash-agent example with reservation/notification
- Added multi-agent usage instructions to bash-agent README
- Closed bd-eimz (QUICKSTART), bd-fkdw (bash-agent), bd-sc57 (production)
- Completed bd-nl8z documentation epic

Amp-Thread-ID: https://ampcode.com/threads/T-5b0d67ff-5eb2-41b3-bc9b-7f33719e0c85
Co-authored-by: Amp <amp@ampcode.com>
This commit is contained in:
Steve Yegge
2025-11-08 01:10:20 -08:00
parent 687c23cf71
commit c3856bb140
4 changed files with 173 additions and 6 deletions
+34
View File
@@ -172,6 +172,40 @@ After upgrading bd, use `bd migrate` to check for and migrate old database files
**AI agents:** Use `--inspect` to analyze migration safety before running. The system verifies required config keys and data integrity invariants.
## Advanced: Agent Mail (Optional)
For **multi-agent workflows** (2+ AI agents working concurrently), Agent Mail provides real-time coordination:
**Benefits:**
- 20-50x latency reduction (<100ms vs 2-5s git sync)
- Collision prevention via file reservations
- Agents can't accidentally claim same issue
**Quick setup:**
```bash
# Install and start server (one-time)
git clone https://github.com/Dicklesworthstone/mcp_agent_mail.git
cd mcp_agent_mail && python3 -m venv .venv && source .venv/bin/activate
pip install -e .
python -m mcp_agent_mail.cli serve-http
# Configure each agent (environment variables)
export BEADS_AGENT_MAIL_URL=http://127.0.0.1:8765
export BEADS_AGENT_NAME=assistant-alpha # Unique per agent
export BEADS_PROJECT_ID=my-project
# Use bd normally - Agent Mail auto-activates
bd ready
bd update bd-42 --status in_progress # Reserves instantly
```
**When to use:**
- ✅ Multiple agents working simultaneously
- ✅ High collision risk (frequent status updates)
- ❌ Single agent workflows (unnecessary overhead)
See [AGENT_MAIL.md](AGENT_MAIL.md) for complete guide.
## Next Steps
- Add labels: `./bd create "Task" -l "backend,urgent"`