Optional Workers send sessions to a Hub you host yourself. Attachments and source files are never transferred.
04Multi-machine
Manymachines. Onehistory.
Run a Hub where you browse, and pair a Worker on each computer you code on. Workers collect locally and upload to your self-hosted Hub. The Hub handles search, cost estimates, and the Web UI.
01
Pair once
A one-time token, valid for 10 minutes, becomes a revocable per-node credential. The Hub stores only its digest.
02
Keeps working offline
When the Hub is unreachable, Workers keep collecting, queue uploads on disk, and catch up after reconnecting.
03
See every source
The source-node panel shows collection progress and errors, starts rescans, and replaces Workers. Background services run on macOS, Linux, and Windows.
Source nodes 2/3 onlineSearch, stats, and cost across machines
laptop
macOS · Worker
Connected
Synced just now · 642 sessions
devbox
Linux · Worker
Collecting
desktop
Windows · Worker
Offline
12 queued · uploads after reconnecting
05Agents
Differentagents. Sameworkspace.
19supported agents
Each agent connects through a core adapter and contributes to one index of sessions, projects, search, and file activity.
Claude Code
Qoder
Qoder CN
Cursor
Droid
Kimi-Cli
Kimi-Code
Codex
Grok
Pi
oh-my-pi
OpenCode
ZCode
MiniMax Code
DSH
DeepChat
Cherry Studio
Antigravity CLIPartial
Gemini CLI
Support levels reflect what each adapter actually parses from sessions, usage, and tool calls.
06Updates & guides
Followtheproduct, notthecommitlog.
See the improvements that change how CodeSesh feels to use, plus the principles guiding what we build next.
Latest updatev1.4.1
Faster Chinese search and less work while idle
CodeSesh 1.4.1 makes Chinese session search faster on large local AI coding histories, reduces background scanning and retained memory, and keeps live updates from piling up during slow requests.
Answers about CodeSesh, installation, data boundaries, and large histories.
01
What is CodeSesh?
CodeSesh is a local developer tool for discovering, aggregating, searching, and replaying AI coding session history. It turns local records from Claude Code, Qoder, Qoder CN, Cursor, Droid, Kimi-Cli, Kimi-Code, Codex, Grok, Pi, oh-my-pi, OpenCode, ZCode, MiniMax Code, DSH, DeepChat, Cherry Studio, Antigravity CLI, and Gemini CLI into a project-aware engineering memory layer.
02
Does CodeSesh upload local AI session data?
In default standalone mode, session data stays on your computer in a local SQLite index. Optional Workers send session content and metadata, including paths, usage, and costs, to your configured self-hosted Hub. Attachments and source files are not transferred. No account is required, and no session telemetry is collected.
03
How do I install and start CodeSesh?
Run npx codesesh in a terminal. CodeSesh scans supported local AI coding sessions and opens its Web UI at http://localhost:4521. If the default port is busy, it tries the next available port. The npm launcher requires Node.js 22 or later. The standalone native executable does not require Node.
CodeSesh opens with sessions active in the last 7 days and keeps scanning older history in the background. Switch the time range in the UI to 30 days, 90 days, All, or a custom range to see older sessions. Until the first scan finishes, older records may be incomplete. If a session is still missing, check the agent filter, source files, and custom data directories. CodeSesh cannot recover deleted source records.
How does CodeSesh stay responsive with a large history?
The first scan persists backfill progress and can resume after interruption. Later starts restore from the local SQLite cache, while file watchers incrementally update changed sessions. Long conversation timelines use viewport virtualization instead of rendering every message at once.
08Install
Keepthecontext. Starthere.
One command opens your local coding history. Choose the installation method that works for you. Open source, free, and your session data stays local.
macOS / Linux / Windows · Node.js 22+ Update: npx codesesh@latest
$curl -sSfL https://codesesh.xingkaixin.me/install.sh | sh
macOS / Linux x64 (glibc 2.35+) · No Node.js required After installing, run codesesh. Stop CodeSesh before updating, then restart it. Update: Run the install command again
$brew install xingkaixin/tap/codesesh
macOS · Homebrew required · No Node.js required After installing, run codesesh. Stop CodeSesh before updating, then restart it. Update: brew upgrade codesesh
Windows x64 · Scoop required · No Node.js required After installing, run codesesh. Stop CodeSesh before updating, then restart it. Update: scoop update codesesh