- Removed bare first-party go install .../cmd/bd@latest guidance from docs,
website docs, plugin/npm docs, examples, and doctor hints.
- Standardized on:
- CGO_ENABLED=0 go install ... for server-mode only
- CGO_ENABLED=1 GOFLAGS=-tags=gms_pure_go go install ... for embedded-
capable
- Added scripts/check-go-install-guidance.sh and wired it into CI.
- Updated default.nix to use gms_pure_go instead of ICU flags.
Validation passed locally:
- make test
- golangci-lint run --build-tags=gms_pure_go ./...
- ./scripts/check-go-install-guidance.sh
- ./scripts/check-build-tags.sh
- go test -tags gms_pure_go ./cmd/bd/doctor
- doc flag check
124 lines
3.3 KiB
Markdown
124 lines
3.3 KiB
Markdown
# Bash Agent Example
|
||
|
||
A bash script demonstrating how an AI agent can use bd to manage tasks autonomously.
|
||
|
||
## Features
|
||
|
||
- Pure bash implementation (no Python/Node required)
|
||
- Colorized terminal output
|
||
- Automatic work discovery
|
||
- Random issue creation to simulate real agent behavior
|
||
- Dependency linking with `discovered-from`
|
||
- Statistics display
|
||
|
||
## Prerequisites
|
||
|
||
- bash 4.0+
|
||
- bd installed: `curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash`
|
||
- jq for JSON parsing: `brew install jq` (macOS) or `apt install jq` (Linux)
|
||
- A beads database initialized: `bd init`
|
||
|
||
## Usage
|
||
|
||
```bash
|
||
# Make executable
|
||
chmod +x agent.sh
|
||
|
||
# Run with default 10 iterations
|
||
./agent.sh
|
||
|
||
# Run with custom iteration limit
|
||
./agent.sh 20
|
||
```
|
||
|
||
## What It Does
|
||
|
||
The agent runs in a loop:
|
||
|
||
1. Looks for ready work (no blockers)
|
||
2. Claims the task (sets status to `in_progress`)
|
||
3. "Works" on it (simulates 1 second of work)
|
||
4. 50% chance to discover a follow-up issue
|
||
5. If discovered, creates and links the new issue
|
||
6. Completes the original task
|
||
7. Shows statistics and repeats
|
||
|
||
## Example Output
|
||
|
||
```
|
||
🚀 Beads Agent starting...
|
||
Max iterations: 10
|
||
|
||
═══════════════════════════════════════════════════
|
||
Beads Statistics
|
||
═══════════════════════════════════════════════════
|
||
Open: 5 In Progress: 0 Closed: 2
|
||
|
||
═══════════════════════════════════════════════════
|
||
Iteration 1/10
|
||
═══════════════════════════════════════════════════
|
||
ℹ Looking for ready work...
|
||
ℹ Claiming task: bd-3
|
||
✓ Task claimed
|
||
ℹ Working on: Fix authentication bug (bd-3)
|
||
Priority: 1
|
||
⚠ Discovered issue while working!
|
||
✓ Created issue: bd-8
|
||
✓ Linked bd-8 ← discovered-from ← bd-3
|
||
ℹ Completing task: bd-3
|
||
✓ Task completed: bd-3
|
||
```
|
||
|
||
## Use Cases
|
||
|
||
**Continuous Integration**
|
||
```bash
|
||
# Run agent in CI to process testing tasks
|
||
./agent.sh 5
|
||
```
|
||
|
||
**Cron Jobs**
|
||
```bash
|
||
# Run agent every hour
|
||
0 * * * * cd /path/to/project && /path/to/agent.sh 3
|
||
```
|
||
|
||
**One-off Task Processing**
|
||
```bash
|
||
# Process exactly one task and exit
|
||
./agent.sh 1
|
||
```
|
||
|
||
## Customization
|
||
|
||
Edit the script to customize behavior:
|
||
|
||
```bash
|
||
# Change discovery probability (line ~80)
|
||
if [[ $((RANDOM % 2)) -eq 0 ]]; then # 50% chance
|
||
# Change to:
|
||
if [[ $((RANDOM % 10)) -lt 3 ]]; then # 30% chance
|
||
|
||
# Add assignee filtering
|
||
bd ready --json --assignee "bot" --limit 1
|
||
|
||
# Add priority filtering
|
||
bd ready --json --priority 1 --limit 1
|
||
|
||
# Add custom labels
|
||
bd create "New task" -l "automated,agent-discovered"
|
||
```
|
||
|
||
## Integration with Real Agents
|
||
|
||
This script is a starting point. To integrate with a real LLM:
|
||
|
||
1. Replace `do_work()` with calls to your LLM API
|
||
2. Parse the LLM's response for tasks to create
|
||
3. Use issue IDs to maintain context
|
||
4. Track conversation state in issue metadata
|
||
|
||
## See Also
|
||
|
||
- [../python-agent/](../python-agent/) - Python version with more flexibility
|
||
- [../git-hooks/](../git-hooks/) - Automatic export/import on git operations
|