Search

A single command, a rich query language. The full DSL is documented on its own page — this is the command surface.

# search

parc search <query>
            [--sort <order>]
            [--limit <n>]
            [--offset <n>]
            [--json]

Runs a query against the vault's FTS5 index and returns matching fragments.

# Full-text
parc search "connection pooling"
parc search '"exact phrase"'

# Filters
parc search 'type:todo status:open priority:high'

# Tag shorthand
parc search '#backend'

# Combined
parc search 'type:todo #backend due:this-week status:open'

# Sort orders

parc search '#backend' --sort updated
parc search 'type:todo' --sort due --limit 20

# Output formats

By default, results render as a compact list with the eyebrow, title, type, and a snippet of matched text:

01JQ7V  todo  open    Upgrade auth library
        #security #backend · due in 3d
        > current JWT library has a known timing **vulnerability**

01JQ7Z  todo  open    Migrate to bcrypt
        #security · due tomorrow

--json returns an array of fragment objects, sorted by the same order:

{
  "ok": true,
  "results": [
    {
      "id": "01JQ7V3XKP5GQZ2N8R6T1WBMVH",
      "type": "todo",
      "title": "Upgrade auth library",
      "tags": ["security", "backend"],
      "status": "open",
      "priority": "high",
      "due": "2026-02-28",
      "snippet": "current JWT library has a known timing vulnerability"
    }
  ],
  "total": 1
}

# Saved queries

You can pipe a query through parc search from a shell function or alias for repeat use. parc itself does not store named queries — keep them in your shell config or as a small script in <vault>/scripts/.

# ~/.zshrc
alias todos-this-week='parc search "type:todo status:open due:this-week"'
alias inbox='parc search "type:note created:today"'

# See also

• Search DSL — the full query language
• Tags & links — how tags merge from frontmatter and inline #hashtags