| name | gloss-search |
| description | Search highlights across all sessions by tag, text, speaker, or kind. Use when asked to 'search highlights', 'find highlights', 'gloss:search', or '/gloss:search'. |
| one_liner | Search highlights across all conversations. |
| activation_triggers | ["gloss:search","search highlights","find highlights","all highlights","highlights tagged","highlights about","When user wants to search or query highlights across multiple sessions"] |
/gloss:search — Search All Highlights
Search highlights across all sessions in ~/.convo/db.sqlite.
Unlike /gloss:highlights (scoped to current session), this searches everything.
Script
bun <GLOSS_DIR>/src/cli.ts highlights
Where <GLOSS_DIR> is the directory containing this skill (the repo root).
Procedure
-
Parse <command-args> to determine the query type:
| User says | CLI flags |
|---|
gloss:search security | --search "security" |
gloss:search --tag architecture | --tag architecture |
gloss:search --tag bug --speaker assistant | --tag bug --speaker assistant |
gloss:search (no args) | --recent 30 (last 30 days) |
gloss:search --tags | --tags (list all tags with counts) |
-
Run the query:
bun <GLOSS_DIR>/src/cli.ts highlights --json <flags>
Common patterns:
bun <GLOSS_DIR>/src/cli.ts highlights --json --search "security" -n 50
bun <GLOSS_DIR>/src/cli.ts highlights --json --tag architecture -n 50
bun <GLOSS_DIR>/src/cli.ts highlights --json --tag bug --speaker assistant -n 50
bun <GLOSS_DIR>/src/cli.ts highlights --json --tags
bun <GLOSS_DIR>/src/cli.ts highlights --json --recent 7
bun <GLOSS_DIR>/src/cli.ts highlights --json --session "<session-id>"
-
Present results organized by relevance:
- Group by session when results span multiple sessions
- Show: quoted text, comment, tags, kind, speaker, session project
- If the user asked a question, synthesize an answer from the highlights
- If listing tags, show them sorted by count with a brief description of what each covers
-
Suggest follow-ups based on what was found:
- "Run
/gloss:search --tag <tag> to drill into a specific tag"
- "Run
/gloss:auto-tag to tag untagged highlights"
- "Open a session with
/gloss:convo <session-id> to see highlights in context"
Examples
/gloss:search security
→ Searches text and comments for "security" across all sessions
/gloss:search --tag architecture
→ All highlights tagged "architecture"
/gloss:search --tags
→ Lists all tags: architecture (12), bug (8), pattern (6), ...
/gloss:search --recent 7
→ Highlights from the last week