Saropa Chats: Search and Resume Claude Code Session History in VS Code
Saropa Chats is a VS Code extension for full-text search of your Claude Code session history. Find an old session by any word or phrase, see which session edited a file, check the git state of a session, and resume the session from the sidebar. It indexes ~/.claude/projects locally in a worker thread, makes no network requests unless you turn on Web sessions, and has no runtime dependencies.
Keywords: Claude Code, AI agent, session history, session search, transcript search, resume session, subagent, git worktree, pull request status, context window, VS Code extension.
What it does
Full-text search of agent sessions, including subagent transcripts.
Click a result to resume that session. Resuming needs the agent extension.
Shows which session edited a file, from the Explorer, editor or tab menu.
Shows the git state of a session in its card: branch, open pull request, uncommitted files, unpushed commits and worktrees.
Warns when a live session nears a full context window.
Project Status page: branches, worktrees, pull requests and sessions of one repository, grouped by what to do next.
Account & Usage: your Claude Code account and the tokens used in the last hours and days.
Token totals per session and per branch, a blue count badge for sessions waiting for you, and automatic session titles.
Claude Config: a read-only review of your Claude Code configuration.
Options screen for every setting, and an optional, opt-in list of Web (cloud) sessions.
Local by default. The optional pull request lookup runs your own gh command (setting saropaChats.lookupPullRequests, on by default). Web sessions are off by default.
Install
Marketplace: search for "Saropa Chats" in the Extensions view, or run:
Or open the Extensions view, choose ... then "Install from VSIX...", and pick the file.
Quick start
Click the Saropa Chats icon in the activity bar.
Wait for the first index to finish. Search works on what is indexed so far.
Type a word or phrase. Results appear after you stop typing. Enter searches at once.
Narrow the results with the match toggles, the Sort icon in the view title bar, the status filter row above the list, and the search details (...) button.
Click a result to resume that session, or click its chevron to read the matching messages.
Tick External (search details) to search sessions from every project, not only this workspace.
Search
Search syntax
Token
Example
Finds
plain text
my family
The exact phrase in one message.
"..."
"regen l10n"
An exact phrase (with Match any order on).
last:<n>
deploy last:20
Matches in the final 20 messages.
from:you or from:agent
deploy from:you
Only your messages, or only the agent's (and subagents'). from:both is the default.
file:<text>
file:search.ts
Sessions that touched a file path, including sessions that only mention it in text or commands.
edited:<text>
edited:search.ts
Sessions that edited a file path.
cmd:<text>
cmd:"npm run"
Sessions where the agent ran a matching command.
tag:<name>
tag:billing
Sessions you tagged.
sha:<prefix>
sha:a1b2c3d
Sessions with a commit that starts with it (4 to 40 hex characters).
pr:<number>
pr:#123
Sessions linked to that PR. pr:123 works too.
branch:<text>
branch:main
Sessions with a branch name containing the text, including branches a tool call of the session or its subagents created.
Tokens combine with plain words and with each other.
Tokens ignore case. A search needs at least 2 characters.
Quote values that contain spaces.
Match options and filters
Option
What it does
Exact phrase (default)
The whole query is one exact phrase in one message.
Match any order (Alt+O)
Words match in any order. "quoted phrases" stay exact.
Match Case (Alt+C), Whole Word (Alt+W), regular expression (Alt+R)
As in VS Code Search. A pattern that stalls for 3 seconds stops with "Search timed out: simplify the pattern".
Messages from
Both, You or Agent. Same as from:. Subagent messages count as the agent.
Messages to search
Last 10, 25, 50 or 100 messages of each session. Same as last:<n>.
Sessions active during
Any time, last hour, 2, 4 or 8 hours, today, this week (rolling last 7 days), Work week (Mon-Sun, from Monday 00:00) or this month (from the 1st, 00:00). Local time.
Search scope
Subs (subagent sessions, on by default), Archive (archived sessions, off by default) and External (every project, off by default).
Sort
Score, Time (grouped by day), Title, Length, Cost or Context. Pinned sessions list first.
Status filter
Mid-size, Active, Empty, Tiny, Huge, Nearly full, Abandoned, Pinned. Each has a count and a tooltip with its rule. Reset turns them all on.
The ... button under the search box ("Toggle search details") shows or hides the time, message, sender and scope controls. A count on the button shows how many differ from the defaults. The choice is remembered per workspace.
The search, filters and session list sit in a collapsible "Session Manager" panel. The search box has a clear (x) button.
Sort and Search Tips are icons in the view title bar and open a quick pick. The status filter is a funnel dropdown in a filter row above the list, with a count pill when a filter is on and an "Active" chip that shows only open sessions that are running, waiting, unread or waiting on background agents.
saropaChats.search.contextLines (1 to 4, default 1) sets how many lines of each match a result row shows. Narrow side bars always show one.
Up and Down in the search box step through your last 20 searches with their toggles.
Ranking and results
Title matches rank first. The whole score decays smoothly with age (never below 30%), so recent and live sessions come first among comparable matches.
One row per session. It shows the newest match (across the session and its subagents) as a snippet of at most two lines, starting just before the match.
"+N more" under the snippet opens the other matches in place, newest first, 20 at a time. Identical texts collapse into one item with a count such as x3.
With a search, the time pill and day groups use the time of the newest match. The session's last active time is in the tooltip and the card.
Like VS Code Search, the panel lists at most 500 sessions (saropaChats.maxResults, 50 to 2000) and says so. Every match is still counted. A session shows "9,999+" above 9,999 hits.
Open in editor (the summary line under the search box, or "Saropa Chats: Open Results in Editor") opens all matches in a read-only "Search: query" tab: a header per session (Cmd/Ctrl+click resumes it), matching lines with one line of context, real JSONL line numbers and highlighted matches.
In All sessions (no search), sessions that are open list above sessions that are not, with a divider. Pinned sessions stay in their own section. The list groups sessions by All Sessions (today), Yesterday, This Week and Older.
Session rows and cards
Status dot
An 8 px dot sits left of each session title. It uses the same states as the agent's own panel.
Dot
Meaning
Green
Running: the agent is working in that session.
Blue
Waiting for you: the agent needs a permission or an answer.
Orange
Unread: the session finished while you were away. This is approximate.
Purple
Waiting on background agents or shells (a launch with no finish notice yet in the transcript).
Grey, faded
Idle.
Hollow ring
A live agent process (terminal, tab or window) that is not running or waiting.
A session with several states at once cycles through their colors. The tooltip lists all of them.
Open window marker: a solid ring means the live session is open in this window. A dashed ring means another window. On Windows, or when ps fails, no marker shows.
Live state comes from ~/.claude/sessions, checked every 30 seconds and when the panel becomes visible. Without those files every session shows idle.
Unread is a guess: a session you saw running or waiting that then went idle or closed. Resuming the session or "Mark as Read" clears it.
saropaChats.animateDots (default on) animates the dots. Off, or with reduced motion, they stay still and show the most important state. Colors: saropaChats.dotRunning, dotWaiting, dotUnread, dotBackground, dotIdle.
The session open in this window is highlighted like the official sidebar. It follows the focused Claude tab.
Context ring, pill and warnings
Tokens: the card shows cumulative tokens per session (input, output, cache read, cache write, kept separate, no price). /compact never lowers them and subagent replies count. Each branch row on Project Status shows a per-branch total.
Context ring: every row with token data shows a small ring that fills as the session's context grows, against saropaChats.contextRingTokens (default 300000, minimum 10000). Warning color at 80 percent, error color at 100 percent or more. Hover for "136.8k of 300k tokens".
Context pill: shown from 60 percent (amber 60 to 79, orange 80 to 89, red 90 and above). The card always shows a Context stat, such as "82% (164k of 200k, opus-4-6)". The figure approximates the agent's own and lags one turn.
Warnings: a live session that reaches 80 or 90 percent gets one notification with Open session and Dismiss (the 90 percent one also offers Copy hand-over note). Each session warns once per level, again after a compaction or after it falls 10 points below the level. At most 1 notification per 30 second check and 3 in 10 minutes. Turn off with saropaChats.contextWarnings.
Activity bar badge: a blue count of sessions waiting for you. It clears when none are.
Status bar: "3 sessions near full" appears only when sessions are 80 percent full or more. Click it to filter to Nearly full. Hide with saropaChats.showUsageStatusBar.
Expanded card
The chevron opens the row as a card with an action bar (Resume, Pin, Archive, Mark read, Copy ID, Copy hand-over note), matched files and commands, labeled stats (cost, lines added and removed, models), tags and five collapsed sections. Nothing for a section is fetched until you open it.
Section
Shows
Git
Branch with commits ahead and behind, working folder, the open pull request for the branch (number, title, state; click opens it), and the PRs and commits the session mentions (click to search). "Created by: created branch X at
Uncommitted files
Changed files. Click opens the file.
Unpushed commits
Up to 20 commits (short id and subject). Click a commit id to search sha: for the session that made it.
Worktrees
Worktrees of the session's repository. The ones the session created are marked; removed ones show "created, now removed".
Related sessions
Up to 5 other sessions that touched the same files.
The card reads the worktree the session (or one of its subagents) created, else the worktree it ran in, else the one for the branch its rows record, else its last folder.
One request per section and working folder runs at a time. A section that fails shows a Retry link.
Copy hand-over note copies the title, session id, folder, branch, last active time, context percent, matched files and live git state. A part that cannot be read in 5 seconds is written as "not available".
Organize
Pin: star a session or use Pin Session / Unpin Session in the row context menu. Pinned sessions list first. Pins are stored per workspace.
Tag: click the tag icon on a row, type a name, press Enter. Click a tag to filter.
Archive: moves a session into a collapsed "Archived sessions" section. A pinned session stays pinned. Archived rows show a dimmer title and greyscale emoji. The archive list is shared by all workspaces.
Import Archived Sessions from the Agent: command "Saropa Chats: Import Archived Sessions from the Agent". Runs only when you ask. Needs sqlite3 on your PATH.
Row context menu: Copy resume command (cd <folder> && claude --resume <id>, quoted for your shell), Export as Markdown, Mark as Read, Archive.
Automatic session titles
Setting saropaChats.autoTitle.enabled (off by default), or the "Auto-title sessions" toggle in the "..." menu of the view. A live session is named after its first prompt (topic emoji plus the first sentence, up to 50 characters) and renamed once after the third prompt, by appending a title line to the session file. Sessions you named yourself are left alone.
autoTitle.useHaiku lets claude -p --model haiku write the title instead of the rules. emojiRules and emojiRulesReplaceDefaults customize the emoji.
"Regenerate Session Titles" (sparkle button in the view toolbar): pick This project or All projects, preview old and new titles, then write. Each transcript is backed up under ~/.claude/backups/session_titles first. Live sessions are skipped.
Account & Usage
A section at the top of the sidebar, closed until opened, laid out like the native Claude Code panel. ACCOUNT shows your email and plan from ~/.claude.json (or "Not signed in"). USAGE shows tokens used in the last 5 hours, today and the last 7 days (input plus output). "View details" adds name, organization, yesterday, 3 and 5 days, the input, output and cache split per window, and tokens per model. No percent of limit or reset time: that needs the network and keychain. Offline and read-only.
Activity
The "Activity" panel under the session list (collapsible) shows Claude as a center circle with eight groups around it: Chat, Memory, Files, Terminal, Web, Agents, Connect and Control. When the current chat gets a new message, the line of its group flashes and fades back over a few seconds; thinking flashes the center. Old messages are not replayed when you open or switch chats. With reduced motion on, the flash is a brief brightness change with no animation. The panel's "..." menu sets the refresh speed and the fade-out speed (Slow, Medium or Fast).
Claude Config
"Saropa Chats: Claude Config" (in the "..." menu of the view) opens a read-only tab. It lists your global (~/.claude) and project Claude Code configuration (CLAUDE.md, settings, permissions, hooks, MCP servers, rules, skills, agents, commands) with findings by category: bloat, duplication, redundancy, gaps, opportunities and risks. It also shows the chat retention setting cleanupPeriodDays. "Copy for AI" copies a secret-free Markdown version.
Options screen
"Saropa Chats: Options" (in the "..." menu of the view) edits every setting of the extension in one form. New settings appear automatically, each has Reset to default, and changes made elsewhere show live.
Web (cloud) sessions
Off by default (saropaChats.webSessions.enabled). When on, a Local | Web toggle appears. The Web list shows title and age; opening one fetches its transcript on demand into a read-only Markdown tab. It uses an unofficial, undocumented Anthropic API with your Claude Code login token (read-only, never stored or logged) and may change without notice. Turning it on asks for your consent first. While off, no network call and no credential read is made.
Find the session that edited a file
Right-click a file in the Explorer, the editor or its tab and choose "Saropa: Find Related Sessions". The panel opens and searches file:<path>. Each row has an edited or read pill, and edited sessions rank first. The status bar shows the count for the active file (saropaChats.showFileSessionsStatusBar).
API for other extensions
Other extensions get a read-only API: chatsForFile(path), tokensForChat(id), tokensForWork(key), listChats(), getChat(id), listWork() and getAccountUsage(). See docs/API.md.
Project Status page
One page answers: what is still open in this repository, and what do I do to close it? Open it with "Saropa Chats: Project Status" or the checklist icon in the sidebar title bar. It covers the repository of the first workspace folder. With no git repository there, it says "Open a git repository folder".
The Work table
One row per branch, with its worktree folder, creation time, pull request and sessions folded in. Pull-request-only branches, remote-only branches and folders git does not list are rows of the same table. Branches and worktrees created by the same session fold into one row titled with that session.
Each row has two lines: a headline "do X" (Answer, Read, Fix checks on, Address review on, Merge, Commit, Push, Remove worktree, Prune) with one action, then only the facts that matter (branch, pull request, ahead or behind, tags, age). The full sentence is in a tooltip.
Groups: Your move, In progress, Safe to remove and Everything else (which also holds sessions without a branch). The number next to a group equals the rows in it.
A headline in plain words at the top.
Sessions on each row
A session is linked by its working folder, its recorded branch, a tool call that created the worktree or branch (git worktree add, git checkout -b, git switch -c, git branch, EnterWorktree), or a subagent that did one of these.
The creator session is listed first. Sessions that only name the branch go under a closed "Mentions only (N)" toggle. Probable links are muted and say why.
The Created cell shows when and by which session. Its tooltip is the receipt: UTC and local time, command, tool_use id and transcript line.
Actions (one labeled action per row)
Open session, Open PR, Ask to finish, Ask to clean up, Copy remove command.
"Ask to clean up" copies a plain-text prompt with receipts (branch, worktree path, PR, creation proof from the reflog, commits only on the branch, current state). It asks what each item is for and not to delete anything before confirmation. The Claude Code panel cannot be pre-filled, so you paste it.
Copy remove command copies git worktree remove (and git branch -d when merged). Pin, Archive and Mark done are on the row. Pinned sessions list first.
Copy summary: a short markdown summary of everything open.
Header and filters
Filter box, a View menu (Sort, Density Relaxed or Compact, and "Show only rows with" Open PR, Failing checks, Uncommitted, Unpushed), Copy summary, Refresh and a "..." menu (Shortcuts, GitHub status, Show done).
GitHub status shows lookup off, gh missing, not signed in, rate limited, failed, or OK with repo count and age.
saropaChats.openWorkDays (1 to 90, default 14) sets how many days of sessions are listed. Open sessions are always listed.
Filter text, state filters and sort are remembered per workspace.
Keyboard: j / Down and k / Up move rows, Home and End jump, Enter opens the session, Space or Right expands, Left collapses, / focuses the filter, Esc clears or closes, ? lists shortcuts.
Safety
The extension never changes your repositories. It runs read-only git commands and read-only gh pr lookups. Every command it offers is copied for you to read and run yourself. None uses --force or -D.
Paths and branch names in copied commands are quoted for your shell. If Windows cannot quote a name safely, no command is offered ("Remove manually").
Usage and housekeeping commands
Command
What it does
Saropa: Usage Summary
Cost per day (14), week (8), project and model, and your 10 priciest sessions. Picking a session resumes it.
Saropa: Show Nearly Full Sessions
Filters the panel to sessions at 80 percent context or more.
Saropa: Archive Empty and Tiny Sessions
Archives sessions with 0 to 3 messages after a modal count confirmation. Pinned and open sessions are skipped.
Saropa: Copy Resume Command
Copies cd <folder> && claude --resume <id>.
Saropa: Export Session as Markdown
Writes one session to a .md file through a save dialog.
Saropa: Find Related Sessions
Searches file:<path> for the chosen file.
Saropa Chats: Project Status
Opens the Project Status page.
Saropa Chats: Open Results in Editor
Opens all matches in a read-only editor tab.
Saropa Chats: Search Tips, Sort Results, Filter by Status
Same as the title bar icons.
Saropa Chats: Clear Search History
Clears the Up/Down history.
Saropa Chats: Import Archived Sessions from the Agent
One-time import of the agent's archive list.
Saropa Chats: Show Diagnostics
Version, index state, agent detection, live session and window counts.
Saropa Chats: Claude Config
Read-only review of your Claude Code configuration.
Saropa Chats: Options
One form for every setting.
Saropa Chats: Regenerate Session Titles
Previews and rewrites session titles, with a backup.
Settings
Setting
Default
Effect
saropaChats.maxResults
500
Most sessions listed (50 to 2000).
saropaChats.activity.fadeMs
4000
How long an Activity flash takes to fade out, in milliseconds (1000 to 10000). Applied live.
saropaChats.activity.refreshMs
250
How often the Activity panel checks the selected chat for new messages, in milliseconds (100 to 2000). Applied live; no checks while the panel is collapsed.
saropaChats.contextRingTokens
300000
Token count that fills the context ring (minimum 10000).
saropaChats.contextWarnings
true
Notify at 80 and 90 percent context.
saropaChats.showUsageStatusBar
true
Status bar item for nearly full sessions.
saropaChats.showFileSessionsStatusBar
true
Status bar count of sessions that touched the active file.
saropaChats.openWorkDays
14
Days of sessions on Project Status (1 to 90).
saropaChats.lookupPullRequests
true
Run gh for open pull requests and checks. Off: gh never starts.
saropaChats.animateDots
true
Animate status dots.
saropaChats.search.contextLines
1
Lines of each match shown in a result row (1 to 4).
saropaChats.webSessions.enabled
false
Show Web (cloud) sessions in a Web tab. Unofficial API, uses your Claude Code login token.
saropaChats.autoTitle.enabled
false
Name sessions automatically: topic emoji plus the first sentence of the first prompt, renamed once after the third prompt. Skips sessions you named yourself.
saropaChats.autoTitle.useHaiku
false
Let claude -p --model haiku write the title in the background instead of the rules. Falls back to the rules on failure.
saropaChats.emojiRules
[]
Your own { "emoji": "🐾", "keywords": ["dog", "cat"] } rules. Same emoji as a built-in rule replaces its keywords; others are added.
saropaChats.emojiRulesReplaceDefaults
false
Ignore the built-in emoji rules and use only yours.
Dot colors are theme colors: saropaChats.dotRunning, dotWaiting, dotUnread, dotBackground, dotIdle.
Keyboard shortcuts (search box)
Key
Action
Alt+C
Toggle Match Case
Alt+W
Toggle Match Whole Word
Alt+R
Toggle regular expression
Alt+O
Toggle Match any order (off while regular expression is on)
Up / Down
Previous or next search in history
Down (not browsing history)
Move to the first result
Enter
Search now
Escape
Restore what you typed before browsing history
Right / Left Arrow (on a row)
Open or close the "+N more" list
How it works
For developers.
The extension reads Claude Code JSONL transcripts in ~/.claude/projects and builds a search index in a worker thread (src/worker.ts, src/build.ts, src/search.ts). The extension host never blocks on indexing or search.
Index data is cached on disk, one record file per session, and refreshed incrementally. Windows share the cache. Folders named records-v<number> in the extension's global storage are removed once they are 7 days untouched. Recently read records are kept in memory, up to 64 MB.
Results stream in while indexing runs. Search scans open and unread sessions first, then newest first.
Live state comes from ~/.claude/sessions (src/liveState.ts). Open-window detection compares each agent process's parent process id with this extension host (src/windowMarker.ts).
Git and pull request state goes through a strict read-only allow-list of git and gh argument shapes (src/wipExec.ts, src/wipPrsArgs.ts). Every shape is listed in SECURITY.md.
Sessions are matched to branches, worktrees and pull requests by one matcher shared by the sidebar card and Project Status (src/gitMatch.ts, src/workMatch.ts).
Webview UI is plain HTML, CSS and script strings (src/webview*.ts, src/openWork*.ts). Colors come from CSS classes, since the webview security policy blocks inline styles.
Development
npm install
npm run compile
node scripts/bench/bench.js
npm run package
npm run compile builds src/ into out/.
node scripts/bench/bench.js prints build, load and query timings for your machine and session folder.
npm run package builds a .vsix. Its vscode:prepublish step runs the checks: the check_*.js scripts in scripts/checks/ (listed in the vscode:prepublish script of package.json).
No runtime dependencies. Dev dependencies only.
Press F5 in VS Code to start an Extension Development Host.
Reads Claude Code transcripts from ~/.claude/projects on your machine.
Reads ~/.claude.json (account email, name, organization, plan) and the ~/.claude configuration files for Account & Usage and Claude Config. Read-only; no keychain and no network.
Writes only when you ask: auto-titles append a title line to a session file, and Regenerate Session Titles backs up each transcript first.
Web sessions (off by default): only when saropaChats.webSessions.enabled is on, it sends your Claude Code login token to Anthropic's unofficial session API to list and fetch your cloud sessions. The token is never stored, refreshed or logged.
Reads the agent's live session files in ~/.claude/sessions (process id, session id and status) to color the dots. It never writes there.
When you open a section of a session card (not when you open the card), it runs local read-only commands with no shell, 5 second limit each, in that session's working folder: git rev-parse --show-toplevel --git-common-dir --abbrev-ref HEAD (every section), then git for-each-ref --format=<fields> refs/heads/<branch> (Git), git status --porcelain=v1 --branch -z (Uncommitted files), git rev-list --max-count=20 --format=<fields> @{u}..HEAD (Unpushed commits) or git worktree list --porcelain -z and git for-each-ref --format=<fields> refs/heads (Worktrees). It never runs fetch, pull, checkout, reset, clean, stash, commit, push or anything that writes. Git is told not to take optional locks and never to prompt.
While saropaChats.lookupPullRequests is on (the default), it runs gh pr list --state open --limit 100 --json number,title,headRefName,isDraft,reviewDecision,url,headRefOid,isCrossRepository,headRepositoryOwner once per repository, plus git remote get-url origin when the list holds a fork pull request, and gh pr view <number> --json statusCheckRollup,headRefOid for Project Status rows. No shell, 8 second limit, answers cached 5 minutes (2 for checks). gh auth status is cached 60 seconds. gh contacts GitHub with your own existing sign-in. The extension adds no network code of its own. Clicking a pull request opens the address gh returned (https only) in your browser. Turn the setting off and gh is never started.
Runs ps -A -o pid=,ppid= (no shell, 3 second limit, once per 30 second poll) to read parent process ids for the open window marker. The output is parsed in memory and not stored.
Reads which sessions are open as tabs from VS Code's workspace storage (state.vscdb) with the local sqlite3 tool, read-only, on a temporary copy that is deleted afterwards. Only session ids are kept.
Import Archived Sessions works the same way and runs only when you press Import.
Writes a search cache to the extension's global storage folder. Message text is stored there, up to 20,000 characters per message (8,000 for subagents). The last cwd of each session, file paths, the first 300 characters of each command, and the worktrees and branches each session created are stored too. Tool results are skipped.
Pins, tags, archived sessions, unread marks, history and options are saved by VS Code in its own storage.
No telemetry. The only network call in the source is the opt-in Web sessions list. The programs it starts are ps, sqlite3, git, gh and claude (only for Haiku auto-titles and the Regenerate Session Titles command).
Resuming a session hands the session id to the agent extension through a VS Code command, or a VS Code link if the command fails.
Errors go to the "Saropa Chats" output channel.
FAQ
How do I search my Claude Code session history in VS Code?
Open the Saropa Chats icon in the activity bar and type a word or phrase. Results list every matching session.
How do I resume an old Claude Code session?
Click a result or press Enter on it. The session opens in the agent panel. This needs the agent extension. To resume in a terminal, use Copy resume command.
Can I search subagent conversations?
Yes. Keep the Subs checkbox on. Subagent matches count toward the parent session. When the newest match is a subagent's, the row shows a purple pill with its agent type.
How do I find which session edited a file?
Right-click the file and choose "Saropa: Find Related Sessions", or search edited:<file name>.
How do I find the session that made a commit or opened a pull request?
Search sha:<prefix> or pr:<number>. In a session card, click a commit id in Unpushed commits.
How do I find which session created a branch or worktree?
Open Project Status. The creator session is listed first on each row. Or search branch:<name>.
How do I know when a session is about to hit its context limit?
Watch the context ring and pill, or leave saropaChats.contextWarnings on. Copy hand-over note carries the state to a new session.
Does it send my sessions anywhere?
No. The only outside contacts are the optional gh pull request lookup (your own sign-in; turn it off with saropaChats.lookupPullRequests) and the opt-in Web sessions list, which is off by default.
Does it change my repositories?
No. It runs read-only git commands. Commands it offers are copied, never run.
Does it work with multiple VS Code windows?
Yes. Windows share one cache with one file per session.
Why does the first start take longer?
The first start builds the index of all your sessions. Later starts read the cache. A new version may rebuild it once.
Where does it store its cache?
In the extension's global storage folder, in folders named records-v<number>.
Does it work on Windows?
Yes. The open window marker is not available there, and copied commands use PowerShell quoting.
Requirements
VS Code 1.90.0 or newer.
The agent extension, to resume sessions.
git, for the Git section of a session card and Project Status. Optional gh (signed in), for pull requests and checks.
Optional sqlite3 on your PATH, for Import Archived Sessions and tab detection.
Optional claude command, for Haiku auto-titles and the Regenerate Session Titles command.
Third-party credits: the icons in the Activity panel are from Codicons (the microsoft/vscode-codicons project on GitHub) by Microsoft, licensed under Creative Commons Attribution 4.0 (CC BY 4.0).