ccsession CLI
An fzf-based CLI that lists sessions of Claude Code, Codex and six more agents across projects and resumes the chosen one.
- 51 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads all local session transcripts, which may hold passwords and keys.
- The `resume` command replaces the process with an interactive agent in another directory.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/ccsessionDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads all local session transcripts, which may hold passwords and keys.
- The `resume` command replaces the process with an interactive agent in another directory.
This is third-party code. Review the repository files before installing.
What it does
`ccsession` gathers local agent sessions into one list across projects, sorted by last activity, with a live preview of the last 30 messages. Search modes are fuzzy, directory-only and full-text over JSONL transcripts, with matches highlighted. The chosen session resumes through the agent command after switching to its original directory. Sources are Claude Code (default), OpenCode, Grok, Codex, Pi, Oh My Pi, Kiro CLI and Cortex Code. The `list --json` and `preview --json` subcommands feed scripts and agents, and the `ccsession` skill teaches an agent to find earlier context.
Who it is for. People who keep dozens of sessions across projects and waste time recalling where a given task was discussed.
Good fit when
- You need yesterday session from another project: `ccsession last` runs the latest one and `--here` limits it to the current directory.
- You remember only a phrase from the conversation and full-text mode searches it across all project transcripts.
- The work happened in Codex and `ccsession --codex` shows its sessions in the same interface.
- An agent looks for earlier context itself: `ccsession list --json --grep "issue 84" --limit 5`.
- Resume must start from the right working directory with no manual `cd`.
Not a fit when
- You need a persistent index over nine agents with message and file-version search.
- fzf 0.58.0 or newer is unavailable.
- Sessions live on a remote machine rather than on disk.
Example request
Use $ccsession to find the session where we worked on issue 84, show its last messages and give me the command to continue.Limitations
`fzf` 0.58.0 or newer is required for interactive picking, since mode switching uses the `change-nth` action. The agent itself must be installed to resume. Installing with `go install` needs Go 1.25 or newer. The skill only searches and shows; `resume` replaces the process with an interactive agent and needs your confirmation. On macOS Gatekeeper may block a prebuilt binary, and `xattr -d com.apple.quarantine` clears the quarantine flag.
How to disable. Delete the `ccsession` binary from `PATH` and remove the skill the way you installed it, or delete the `.agents/skills/ccsession` folder. The program does not change session data.
FAQ
How do I install ccsession?
With `go install github.com/sorafujitani/ccsession/cmd/ccsession@latest` or a prebuilt binary from releases. `fzf` 0.58.0 or newer is required.
How do I switch the agent?
With `--codex`, `--grok`, `--pi`, `--omp`, `--kiro`, `--cortex` or `--source=opencode`. With no flag, Claude Code sessions are used.
How do I install the skill?
With `npx skills add sorafujitani/ccsession --skill ccsession`; add `-g` for all projects. Call it with `$ccsession` or a plain request to find a session.
How do I search the conversation text?
Switch to full-text mode in the interface or use `ccsession list --grep Q`. The `--regex` option enables regular expressions.
Does ccsession change the sessions?
No, search and preview only read files. `ccsession resume <id>` starts the agent in the right directory.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI that hands session context between coding agents: continue a Claude Code session in Codex, Cursor, OpenCode and others.
A terminal session manager for Claude Code, Cursor CLI, Kiro CLI and Codex: names, tags, projects, search and resume.
claude-history searches and opens past Claude Code, Codex and Pi conversations in the terminal and gives Claude a history skill
Local search across all coding agent sessions with a return to the original CLI and token usage stats.
A skill for searching past sessions: a full-text index of Claude Code, Codex, pi and Grok chats in one SQLite database
Terminal search across Claude Code, Codex, OpenCode and other agent sessions, with a jump back into the right chat
README in short
A Go program with no cgo reads session files of several agents and shows them through fzf. Agents get JSON output and a separate skill.