Claude Code · terminal

sessio

Find and resume your past Claude Code sessions — the right one, in the right directory — without hunting through claude --resume.

Latin · sessiō — a sitting, a session. The root the English word grew from.

$npm i -g sessio View on npm Star on GitHub
sessions
←→ project · ↑↓ move · type · ^f search-in-text · ⇥ expand-reply · ↵ resume · esc quit · live
 All   web-app  api  cli-tool  docs  mobile 
 
 add rate limiting to auth routes      api         14K  2m 
 fix login redirect loop              web-app      9K  3h
 refactor cache layer                 api         22K  8h
  write onboarding docs                docs        11K  1d
 ↓ 291 more — press ↓ to reveal
──────────────────────────────────────────────────────────
add rate limiting to auth routes  named
api · 2m ago · 14 prompts · 14K · main
reply · [2m]
 Added a token-bucket limiter on the login and signup
 routes; over-limit requests now return 429 with a
 Retry-After header. Tests pass. … ⇥ for full

What it does

Project tabs

Sessions grouped by working directory. to switch, or see them All at once.

/Type to filter

Literal matches win; when there are none, sessio falls back to fuzzy matching by title, project, or first prompt.

^fFull-text search

Greps the entire transcript body for a term across every session on disk, via ripgrep.

Pick up work

The open tab surfaces unanswered prompts, next-step requests, and recent projects with uncommitted changes.

^aArchive locally

Hide sessions you are done with without touching Claude’s transcript files; restore them from the archived tab at any time.

Live & recent

Refreshes every 2s. A running session floats up with a green dot; recent ones stay orange.

Rendered preview

Title, branch, prompt count, the compact summary, first/last prompt, and Claude's last reply as markdown.

Resume where you left off

Runs claude --resume in the original directory. Under Ghostty, opens a new window; ^o keeps the current one.

Keys

KeyAction
Switch project tab
Move selection ( reveals more)
typeFilter by name / project / first prompt
^fFull-text search the current query across all transcripts
^aArchive / unarchive the selected session locally
/ ^eExpand / collapse the reply preview
Resume selected session (Ghostty: new window)
^oResume in this window, including under Ghostty
?Toggle the full keybinding help
escClear content search, then quit

Install

zsh
# install globally (adds the `sessions` command)
$ npm install -g sessio

# run it
$ sessions

# optional: full-text search needs ripgrep
$ brew install ripgrep   # or: apt install ripgrep

Requires Node.js ≥ 16 and Claude Code (the claude binary on your PATH). macOS and Linux.

Note: sessio reads Claude Code's transcript files at ~/.claude/projects/**/*.jsonl. That format is undocumented and internal to Claude Code — it may change without notice. sessio parses defensively and degrades gracefully, but this project is not affiliated with or endorsed by Anthropic.