# Readwise Queries This folder is reserved for agent-authored outputs derived from the `readwise` CLI. ## Boundary - `Readwise/` is plugin-managed sync output from the official Obsidian Readwise plugin. - `Readwise Queries/` is for temporary or retrieval-oriented notes created by agents. - `Notes/` is for durable synthesis, argument development, and cross-linked thinking. ## Default Handling - Do not edit files in `Readwise/` unless explicitly asked. - If a query answer needs to be saved as a vault artifact, save it here unless it has already become a real note. - If the output is no longer just retrieval and has become part of ongoing research, move or rewrite it into `Notes/`. ## Canonical Workflows ### Query A Particular Text 1. Search for the document. 2. Fetch the full document details. 3. Pull highlights if useful. 4. Answer from the CLI result, then link to synced notes only if needed. ```bash readwise reader-search-documents --query "author title or topic" readwise reader-get-document-details --document-id <id> readwise reader-get-document-highlights --document-id <id> ``` ### Search Across The Reading Corpus Use both document search and highlight search when the user asks about a concept rather than one named text. ```bash readwise reader-search-documents --query "topic" readwise readwise-search-highlights --vector-search-term "topic" ``` ### Save To Reader ```bash readwise reader-create-document --url "https://example.com/article" ``` The plugin can sync the resulting document and any later highlights into `Readwise/`. ### Triage The Inbox ```bash readwise reader-list-documents --location new --limit 10 --response-fields title,author,summary,word_count,category,saved_at readwise reader-get-document-details --document-id <id> readwise reader-move-documents --document-ids <id> --location later readwise reader-move-documents --document-ids <id> --location archive ``` ### Organize Around A Project ```bash readwise reader-add-tags-to-document --document-id <id> --tag-names project-name readwise reader-move-documents --document-ids <id> --location shortlist ``` ### Daily Review ```bash readwise readwise-get-daily-review ```