> ## Documentation Index
> Fetch the complete documentation index at: https://beads.gascity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bd query

> Query issues using a simple query language

Generated from `bd help --doc query`.

Query issues using a simple query language that supports compound filters,
boolean operators, and date-relative expressions.

The query language enables complex filtering that would otherwise require
multiple flags or piping through jq.

Syntax:
field=value       Equality comparison
field!=value      Inequality comparison
field>value       Greater than
field>=value      Greater than or equal
field\<value       Less than
field\<=value      Less than or equal

Boolean operators (case-insensitive):
expr AND expr     Both conditions must match
expr OR expr      Either condition can match
NOT expr          Negates the condition
(expr)            Grouping with parentheses

Supported fields:
status            Stored status (open, in\_progress, blocked, deferred, closed). Note: dependency-blocked issues stay "open"; use 'bd blocked' to find them
priority          Priority level (0-4)
type              Issue type (bug, feature, task, epic, chore, decision)
assignee          Assigned user (use "none" for unassigned)
owner             Issue owner
label             Issue label (use "none" for unlabeled)
title             Search in title (contains)
description       Search in description (contains, "none" for empty)
notes             Search in notes (contains)
created           Creation date/time
updated           Last update date/time
started           Date/time issue first transitioned to in\_progress
closed            Close date/time
id                Issue ID (supports wildcards: bd-\*)
spec              Spec ID (supports wildcards)
pinned            Boolean (true/false)
ephemeral         Boolean (true/false)
template          Boolean (true/false)
parent            Parent issue ID
mol\_type          Molecule type (swarm, patrol, work)

Date values:
Relative durations: 7d (7 days ago), 24h (24 hours ago), 2w (2 weeks ago)
Absolute dates: 2025-01-15, 2025-01-15T10:00:00Z
Natural language: tomorrow, "next monday", "in 3 days"

Examples:
bd query "status=open AND priority>1"
bd query "status=open AND priority\<=2 AND updated>7d"
bd query "(status=open OR status=blocked) AND priority\<2"
bd query "type=bug AND label=urgent"
bd query "NOT status=closed"
bd query "assignee=none AND type=task"
bd query "created>30d AND status!=closed"
bd query "label=frontend OR label=backend"
bd query "title=authentication AND priority=0"

```
bd query [expression] [flags]
```

**Flags:**

```
  -a, --all           Include closed issues (default: exclude closed)
  -n, --limit int     Limit results (default: 50, 0 = unlimited) (default 50)
      --long          Show detailed multi-line output for each issue
      --offset int    Skip the first N matching results (0-based). Only supported under --proxied-server.
      --parse-only    Only parse the query and show the AST (for debugging)
  -r, --reverse       Reverse sort order
      --sort string   Sort by field: priority, created, updated, closed, status, id, title, type, assignee
```