| name | vault-search |
| description | Use to search Obsidian vault by keyword. Triggers on "옵시디언에서 찾아", "vault 검색", "관련 노트", "이전에 작성한", "예전에 정리한". |
Vault Search — Search Obsidian Vault
Process
Delegate to archivist agent (haiku):
- Search —
scripts/vault-search.sh --query "{keyword}" [--project {PROJECT}] [--limit 10]
- If current project context is known, add
--project {PROJECT}
- For session-start orientation, inspect bounded compiled context first with
scripts/wiki-context.sh --project {PROJECT} --budget 6000; then use vault-search for detail pages on demand.
- Parse results — Parse the JSON array and display in numbered format:
### Search Results: "{keyword}" (N found)
1. `project/type/title.md` — matching context summary
2. ...
- Read selected note — When the user selects a specific note:
scripts/vault-read.sh read --path {NOTE_PATH}
- Backlinks — When the user requests linked documents:
scripts/vault-read.sh backlinks --path {NOTE_PATH}
- Offer next — "Let me know if you'd like to read any of these notes in detail."
Empty Results — Retry Strategy
| Step | Method | Example |
|---|
| 1 | Split keyword | "제품주문 관리" → search "제품주문" and "관리" separately |
| 2 | Translate between English/Korean | "IAM" ↔ "권한", "order" ↔ "주문" |
| 3 | Browse by project folder | scripts/vault-search.sh --query "{keyword}" --project "{project}" |
| 4 | Search by tag | scripts/vault-search.sh --query "tag: {tag}" |
Reference
ref/cli-reference.md — Obsidian CLI commands (for understanding internal script behavior)
Search Scope
Default: entire vault
If user specifies project: add --project {PROJECT}
DO NOT include any Grep/Glob direct tool call instructions. All search goes through scripts.