Document JSON filter queries with examples

Add examples showing how to query beads using JSON filters:
- Filter by status, issue_type, assignee
- Filter by priority range
- Filter by labels
- Filter unassigned tasks
This commit is contained in:
Levi Neely 2026-02-20 22:41:05 +01:00
parent d0b143949d
commit 8553362628
1 changed files with 19 additions and 0 deletions

View File

@ -292,6 +292,25 @@ echo "undep bd-xyz bd-abc" | 9p write agent/beads/ctl
9p read agent/beads/bd-abc/json | jq
```
### Query with JSON filter
```bash
# Find all open bugs assigned to you
echo '{"status":"open","issue_type":"bug","assignee":"agent-123"}' | 9p write agent/beads/query
9p read agent/beads/query | jq
# Find high priority tasks (priority 1-2)
echo '{"priority_min":1,"priority_max":2}' | 9p write agent/beads/query
9p read agent/beads/query | jq
# Find beads with specific label
echo '{"labels":["urgent"]}' | 9p write agent/beads/query
9p read agent/beads/query | jq
# Find unassigned open tasks
echo '{"status":"open","no_assignee":true}' | 9p write agent/beads/query
9p read agent/beads/query | jq
```
### Add comment
```bash
echo "comment bd-abc \"Fixed the bug\"" | 9p write agent/beads/ctl