Claude Code Sessions banner
craigstoller craigstoller

Claude Code Sessions

Development community

Description

Unofficial tool for Claude Code sessions on disk: make a session visible under your other Claude account on the same machine, or move one between project folders. Command line or GUI. Journaled, reversible, fails closed.

Installation

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

README

claude-code-sessions

See your Claude Code sessions under your other Claude account on the same machine — and move sessions between project folders. Journaled, reversible, fails closed.

**Unofficial.** Not affiliated with Anthropic. Reverse-engineered on-disk formats; fails closed when it sees anything it doesn't recognize.

**Not to be confused with** `claude-code-sessions\` — the folder *Claude Desktop* keeps your per-account session list in, which this tool reads. This tool's own bookkeeping lives in `~/.claude-code-journal/` and is safe to delete.

**Companion read:** [The session that synced itself](https://github.com/craigstoller/claude-code-sessions/blob/main/docs/the-session-that-synced-itself.md) — what Claude Desktop actually keeps on disk, and why this tool is built out of refusals.

The problem

**Claude Desktop files its session list per account.** Switch logins and the sessions you started under the other one disappear from the sidebar. They are not gone: the conversation itself is a single shared file carrying no account identity at all, sitting untouched on your disk. Only the *listing row* — the sidebar entry pointing at it — is private to each login, and the app reads only the folder belonging to the account you are signed into right now. `sync` copies that row into your other account's store, so the session shows up there too.

**Separately, every session is filed under the directory it was started in**, and there is no official way to move one afterwards — a session begun in the wrong folder is stuck there. `move` relocates the transcript and every listing row that points at it, verifying each side before touching the other, so the session reopens cleanly in its new home.

Install

pipx install claude-code-sessions

This installs three commands: `claude-code-sessions` and `ccs` (identical — the short one is for everyday use; examples below use the long form), plus `ccs-gui`, a window for people who would rather not use