feat(search): find threads by conversation content

[t3dotgg]

Thread search only matched shell metadata, so finding older work by what was actually said or delivered was frustrating.

This adds a bounded search RPC for user messages and canonical final agent responses. Web, desktop, and mobile query connected environments after a 200 ms debounce, preserve instant local title/project/branch matching, and fall back cleanly when an environment is disconnected or running an older server. Content matches show the selected variant C You: / Agent: excerpt without replacing existing thread metadata.

Design preview: selected variant C mock

Real screenshot

Verification:

• 60 focused contract, query, client-runtime, web, and mobile tests
• WebSocket RPC routing test
• Contracts, client-runtime, web, mobile, and server typechecks
• Targeted lint and diff checks

Built with GPT-5.6 Sol in the Codex harness.

---

Note

Medium Risk
New read RPC and SQL search over message projection data with bounded inputs; broad UI surface (web palette, mobile lists) but no auth or write-path changes.

Overview
Adds thread content search so users can find work by what was said or delivered, not only thread titles and project metadata.

Server & contracts: New orchestration.searchThreads WebSocket RPC (orchestration read scope) queries projection tables for user messages and canonical final assistant outputs on active, non-archived threads. Results are bounded (query length, limit), deduped to one match per thread, and include snippets. Interim assistant text, system messages, archived/deleted threads, and literal % in queries are handled safely in SQL.

Client-runtime: Shared thread-search module merges per-environment RPC results via atom families; failed or older servers are ignored so local title/project/branch matching still works.

Web: Command palette uses debounced useThreadSearch (≥2 chars, connected environments) and shows You: / Agent: excerpts with highlighted terms under thread rows without replacing project/branch context. Pending search shows “Searching thread messages…”.

Mobile: Home and thread navigation sidebar wire the same search into v1 groups and thread list v2 filtering via matchedThreadKeys, pass excerpts into list rows, and gate empty states while search is pending. Environment filter options include connection state so only connected environments are searched.

Docs: Keybindings doc notes palette message search behavior.

^{Reviewed by Cursor Bugbot for commit 1fc3070. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add thread message content search to command palette and thread list sidebar

• Adds a searchThreads RPC method to the orchestration WebSocket layer, backed by a new SQL query in ProjectionSnapshotQuery.ts that searches user messages and canonical assistant outputs in active threads, deduplicating to one match per thread.
• Introduces threadSearch.ts with createThreadSearchResultsAtomFamily and useThreadSearch hooks (web and mobile) that debounce queries, fan out across connected environments, and aggregate results.
• Thread list sidebar (mobile) and command palette (web) now filter results by message content matches in addition to title, and render a labeled, highlighted snippet excerpt per match.
• Empty states show "Searching thread messages…" while results are pending; search requires at least 2 characters and uses SQLite ASCII case-insensitive LIKE matching.
• Risk: each keystroke (after debounce) issues a WebSocket RPC per connected environment; failures from individual environments are silently ignored.

^{Macroscope summarized 1fc3070.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: a4be1a37-3d12-4968-9122-0f76a9df4e71

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 2683db9. Configure here.}

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR introduces a new search feature enabling users to find threads by conversation content, including new server-side RPC endpoints, database queries, client state management, and UI components. New features introducing user-facing capabilities warrant human review.

^{You can customize Macroscope's approvability policy. Learn more.}