JSON Mode

Every Bowerbird command supports JSON mode for scripting and AI integration.

JSON Output

Add --output json to any command:

bwrb list task --output json
bwrb audit --output json
bwrb search "My Note" --output json

JSON Input

Provide field values without interactive prompts:

bwrb new task --json '{"name": "Fix login", "priority": "high"}'
bwrb edit "My Task" --json '{"status": "done"}'
bwrb bulk set --json '{"status": "archived"}' --type task

Scripting Examples

Create Note from Script

#!/bin/bash
bwrb new task --json "{
  \"name\": \"$TASK_NAME\",
  \"priority\": \"$PRIORITY\"
}"

Process Audit Results

bwrb audit --output json | jq '.violations[] | .file'

Batch Operations

bwrb list task --output json | \
  jq -r '.[] | select(.status == "done") | .path' | \
  xargs -I {} bwrb delete {} --execute

AI Integration

JSON mode makes Bowerbird scriptable by AI assistants:

# AI can read vault state
bwrb list --output json

# AI can create notes
bwrb new idea --json '{"name": "AI suggestion", "status": "raw"}'

See Also

• Shell completion
• AI integration