copilot-sessions

A terminal UI for finding and browsing previous GitHub Copilot CLI sessions.

Reads from ~/.copilot/session-store.db and ~/.copilot/session-state/<id>/. Read-only.

Install

From npm (once published):

npm install -g copilot-sessions
copilot-sessions

Or try it without installing:

npx copilot-sessions

From source:

npm install
npm run build
npm link

Usage

copilot-sessions

Set COPILOT_HOME to override the default ~/.copilot location.

Platforms

Works on macOS, Linux, and Windows with a single install path — no native compilation. SQLite is provided by sql.js (WASM), so npm install / npx never needs to rebuild a native module.

• macOS — uses pbcopy / open. No setup.
• Linux — needs one of wl-copy (Wayland), xclip, or xsel on $PATH for yank. xdg-open for o.
• Windows — uses clip.exe and start. Best run in Windows Terminal (legacy cmd.exe console has spotty raw-mode/ANSI support).

Keys

| Key | Action | | --- | ------ | | / | focus search | | Esc | clear focus / close overlay | | j k / ↑ ↓ | move selection | | Tab / Shift+Tab | cycle focus (search → list → detail) | | 1..4 | switch detail tabs (Overview, Turns, Checkpoints, Files) | | g / G | top / bottom | | Ctrl-d / Ctrl-u | half-page | | Enter | expand turn | | y | yank session id | | Y | yank session folder path | | o | open session folder | | ? | help overlay | | q / Ctrl-c | quit |