[Mbeaulne]

Intent

Help people find a project or an old session quickly once the Projects sidebar gets long.

Current behavior

• The Projects sidebar lists every project you created or pinned, but there's no way to search it.
• Finding an old session means scrolling, opening projects one at a time, and clicking "Show more" in each.

What changes

• A quiet search box sits under "New chat": a magnifier icon and a grey "Search" placeholder, with the same light hover as the rows around it.
• Typing filters the list by project name and session title, ignoring case. Untitled sessions are found by the name the sidebar shows them with, such as "Session 2".
• A project with matching sessions opens and shows only those sessions, all of them. A project that matches only by name keeps its usual open or closed state.
• When nothing matches, the sidebar says "No matching projects or sessions".
• Escape, or the "×" in the box, clears the search and brings the full list back. Opening or closing projects while searching doesn't change the layout the sidebar remembers.
• Other projects' sessions are only loaded once you start typing. On the first search, matching sessions can appear a moment after the projects do.

How to test

1. Open a project in Tangent, with at least three projects that each have a session, one of them renamed (for example "Publish Hello World").
2. Click "Search" under "New chat" and type part of a project's name. Only projects whose names match stay in the list.
3. Clear the box with the "×" and type part of the renamed session's title, such as "publish". Its project opens and shows only that session.
4. Click the session. It opens in place, as it does without a search.
5. Type "session 1". Each project's first untitled session is listed under its project.
6. Type something nothing matches. The sidebar says "No matching projects or sessions".
7. Press Escape. The box empties and every project comes back, open or closed as it was before you searched.
8. With a search typed, open or close a project, then clear the search and reload the page. The projects are open or closed as they were before you searched.

Checks run on this branch: typecheck, lint, Prettier on the changed files, and knip are clean, and the 706 tests in the Tangent and project-service folders pass, including new ones for the search. Not yet tried in the browser.

Related Issue and Pull requests

• Stack: part 6 of 10. Merge in order: Underline the Tangent tab strips and hide resting scrollbars #3010 → Give the Tangent project lists one row design #3011 → Replace the Tangent Sessions panel with a Projects sidebar #3012 → Move Tangent project tools into a card, a settings dialog and the app bar #3013 → Open Tangent agents from the chat's agents pill #3007 → Search projects and sessions from the Tangent sidebar #3016 (this PR) → Offer the project's pipelines, documents and runs to the chat's # picker #3018 → Show a green plug beside project settings while VS Code is connected #3019 → Rework the Tangent project card around reports, runs, pipelines and documents #3021 → Open runs from the chat, and list each chat's runs in a pill #3022.
• Doesn't need any further tangent-shell changes.

Type of Change

• New feature

Line Breakdown

Category	Added	Removed
Production code	220	24
Comments	21	7
Tests	196	4
Total	437	35

Checklist

• I have tested this does not break current pipelines / runs functionality
• I have tested the changes on staging

Screenshots (if applicable)

None yet.

Additional Comments

• Shared code: useProjectResources now builds its query from an exported projectResourcesQueryOptions, so the sidebar can read many projects' sessions from the same cache. The hook behaves as before.

🤖 Generated with Claude Code

[github-actions]

🎩 Preview

A preview build has been created at: MB/tangent-sidebar-search/0fc7f66