From 85533626284ec9eee77eb913172541f2e5b17712 Mon Sep 17 00:00:00 2001 From: Levi Neely Date: Fri, 20 Feb 2026 22:41:05 +0100 Subject: [PATCH] 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 --- skills/beads/SKILL.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/skills/beads/SKILL.md b/skills/beads/SKILL.md index 042f481..7275f60 100644 --- a/skills/beads/SKILL.md +++ b/skills/beads/SKILL.md @@ -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