search (Desktop global search)

CRITICAL — before doing anything, load the olares-shared skill first (profile selection, login, token refresh, auth-error recovery). Flag reference: olares-cli search --help.

Source of truth for flags is always olares-cli search --help. This file only carries what --help cannot give: what the index covers, how search differs from files, the session model, and the error → fix matrix.

When to use

• Find content by keyword across the user's data: "where is the file that mentions X", "search my drive for invoice", full-text / Text Search, Desktop global search.
• Data sources (--app): drive (user Drive files, default) and sync (Seafile / Sync libraries).
• Keywords: Olares search, full-text search, find by content, Text Search, global search, search drive, search sync.

Anything outside this scope -> see the Skill suite map in ../olares-shared/SKILL.md (already loaded as the suite prerequisite).

Mental model: search answers "which file CONTAINS this text" by querying the pre-built per-user index. To LIST or READ a known path, use olares-files (files ls / files cat / files download).

What it is

olares-cli search <keyword> is the CLI mirror of the Olares Desktop global search dialog ("Text Search", reached via the Dock search icon / Shift+Space). It runs full-content retrieval against the per-user search3 index — the same index the desktop SPA queries — so it returns hits by file content, not just filename.