testerez

Raycast Agent Sessions — Development skill for Claude Code

Development community

Raycast extension: search and resume Claude Code and Codex sessions.

How to install Raycast Agent Sessions

This entry records only its repository, not the path inside it, so there is no exact command to give. Open testerez/raycast-agent-sessions and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Raycast Agent Sessions does

Raycast extension: search and resume Claude Code and Codex sessions.

Alternatives in Development

Resume Work From A Handoff Document — You are tasked with resuming work from a handoff document through an interactive process 10k ★
Native Feel Skill — An Agent Skill for designing cross-platform desktop apps that feel native — distilled from Raycast's 2.0 deep 1.9k ★
Harness Remote — Native-session control plane for Codex, Claude Code, OpenCode, OMP and PI 356 ★

README

Agent Sessions (Raycast)

Search and resume coding-agent sessions across tools. Claude Code and Codex are supported today; the provider interface is designed so Cursor can be added later.

Everything is local: transcripts are read from `~/.claude` and `~/.codex`, the index lives in Raycast's support directory for this extension, and nothing is uploaded anywhere.

What it does

One search box over every historical session, not only recent ones: PR numbers (832, #832, PR 832, a GitHub PR URL), Linear keys (ZAP-1793), branch names, file names, symbols, or any phrase from the conversation.
PR-aware ranking. A session that actually worked on PR #832 (Claude pr-link record, branch pr-832-…, the PR URL in your prompt) ranks far above a session where "832" merely appears in some output.
Metadata per session: agent, title, project/repo, branch, created and last-activity dates, PR and issue tags, message count, the prompt that started it and the last one.
Resume in one keystroke. Enter opens the session where it came from: Claude Desktop (claude://resume?session=) or the Codex app (codex://threads/) for desktop-created sessions, otherwise claude --resume / codex resume in your terminal, in the session's working directory. Both options are always available in the action panel, along with copy-command, copy-id, open-PR, show-in-Finder and open-in-editor actions.

Install and run locally

Requirements: Raycast 1.9x+ (ships Node 22, whose built-in `node:sqlite` provides FTS5), Node 22+ and npm on your machine for building.

git clone https://github.com/testerez/raycast-agent-sessions.git
cd raycast-agent-sessions
npm install
npm run dev

`npm run dev` runs `ray develop`, which registers the extension in Raycast in development mode and hot-reloads on changes. Open Raycast and run **Search Agent Sessions**. The first run indexes all transcripts (about 10 s for 1,600 files / 3 GB here) and shows a prog