File contents Workflow: Search Vault
Search vault using DQL (Dataview Query Language), content search, or tag filtering.
Steps
Determine search type based on intent:
Structured query (table, list) -> DQL/Dataview
Text content search -> Content (grep-like)
Tag/property filter -> JsonLogic
Build query using appropriate syntaxExecute search via Tools/SearchVault.py searchFormat results as table, JSON, or text
Tool Usage
# Check if Obsidian REST API is available
python Tools/SearchVault.py status
# Dataview query
python Tools/SearchVault.py search --type dataview \
"TABLE status, tags FROM \"01 - Projects\" WHERE status != \"completed\""
# Content search (grep-like)
python Tools/SearchVault.py search --type content \
--query "kubernetes deployment" \
--folder "03 - Resources"
# JsonLogic search
python Tools/SearchVault.py search --type jsonlogic \
--filter '{"and": [{"glob": ["01 - Projects/**", {"var": "path"}]}]}'
# Output formats
python Tools/SearchVault.py search --type content --query "topic" --json
python Tools/SearchVault.py search --type content --query "topic" --table
Search Types
Type
When to Use
Example
dataviewStructured queries with TABLE/LIST/TASK
TABLE status FROM "01 - Projects"
contentFull-text search across files
--query "search term"
jsonlogicComplex property/path filtering
JSON filter object
Options
Flag
Description
--typedataview, content, jsonlogic
--querySearch text (for content type)
--folderLimit to folder
--tagsFilter by tags
--jsonJSON output
--tableTable output
--limitMax results
Fallback Behavior
When Obsidian REST API is unavailable:
Content search falls back to direct file grep via pathlib + regex
DQL queries are not available (requires Dataview plugin running)
JsonLogic is not available (requires REST API)
Context Files
reference/rest-api.md - API endpoints, DQL syntaxreference/vault-organization.md - Folder structure for scoping searches
1 --- 2 name: 407-searchvault-9bbec4be 3 description: Workflow: Search Vault 4 --- 5 # Workflow: Search Vault 6 7 Search vault using DQL (Dataview Query Language), content search, or tag filtering. 8 9 ## Steps 10 11 1. **Determine search type** based on intent: 12 - Structured query (table, list) -> DQL/Dataview 13 - Text content search -> Content (grep-like) 14 - Tag/property filter -> JsonLogic 15 2. **Build query** using appropriate syntax 16 3. **Execute search** via `Tools/SearchVault.py search` 17 4. **Format results** as table, JSON, or text 18 19 ## Tool Usage 20 21 ```bash 22 # Check if Obsidian REST API is available 23 python Tools/SearchVault.py status 24 25 # Dataview query 26 python Tools/SearchVault.py search --type dataview \ 27 "TABLE status, tags FROM \"01 - Projects\" WHERE status != \"completed\"" 28 29 # Content search (grep-like) 30 python Tools/SearchVault.py search --type content \ 31 --query "kubernetes deployment" \ 32 --folder "03 - Resources" 33 34 # JsonLogic search 35 python Tools/SearchVault.py search --type jsonlogic \ 36 --filter '{"and": [{"glob": ["01 - Projects/**", {"var": "path"}]}]}' 37 38 # Output formats 39 python Tools/SearchVault.py search --type content --query "topic" --json 40 python Tools/SearchVault.py search --type content --query "topic" --table 41 ``` 42 43 ### Search Types 44 45 | Type | When to Use | Example | 46 |------|------------|---------| 47 | `dataview` | Structured queries with TABLE/LIST/TASK | `TABLE status FROM "01 - Projects"` | 48 | `content` | Full-text search across files | `--query "search term"` | 49 | `jsonlogic` | Complex property/path filtering | JSON filter object | 50 51 ### Options 52 53 | Flag | Description | 54 |------|-------------| 55 | `--type` | `dataview`, `content`, `jsonlogic` | 56 | `--query` | Search text (for content type) | 57 | `--folder` | Limit to folder | 58 | `--tags` | Filter by tags | 59 | `--json` | JSON output | 60 | `--table` | Table output | 61 | `--limit` | Max results | 62 63 ## Fallback Behavior 64 65 When Obsidian REST API is unavailable: 66 - Content search falls back to direct file grep via `pathlib` + regex 67 - DQL queries are not available (requires Dataview plugin running) 68 - JsonLogic is not available (requires REST API) 69 70 ## Context Files 71 72 - `reference/rest-api.md` - API endpoints, DQL syntax 73 - `reference/vault-organization.md` - Folder structure for scoping searches
commit f993e0fa06
Frequently asked questions How do I install the 407 Searchvault 9bbec4be skill? Run npx skillmds@latest add tools-only/407-searchvault-9bbec4be in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the 407 Searchvault 9bbec4be skill do? Workflow: Search Vault It is listed under Productivity on SkillMD.
Is 407 Searchvault 9bbec4be safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with 407 Searchvault 9bbec4be? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is 407 Searchvault 9bbec4be free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published 407 Searchvault 9bbec4be? tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tools-only