# CodeSesh

> CodeSesh is a local developer tool that turns AI coding session history from Claude Code, Cursor, Kimi, Codex, and OpenCode into project-aware, structurally searchable, replayable engineering memory.

## Links

- [Landing page](https://codesesh.xingkaixin.me/)
- [Full AI knowledge file](https://codesesh.xingkaixin.me/llms-full.txt)
- [Markdown landing page](https://codesesh.xingkaixin.me/index.md)
- [GitHub repository](https://github.com/xingkaixin/codesesh)
- [English README](https://github.com/xingkaixin/codesesh/blob/main/README.md)
- [Chinese README](https://github.com/xingkaixin/codesesh/blob/main/README_CN.md)
- [npm package](https://www.npmjs.com/package/codesesh)

## What It Does

CodeSesh scans local AI coding agent session files and presents them in one Web UI. It helps developers recover previous decisions, replay complete conversations, search across local sessions, browse by project, inspect file activity, understand token and cost history, and keep AI-assisted engineering work traceable over time.

## Supported Agents

- Claude Code
- Cursor
- Kimi
- Codex
- OpenCode

## Primary Use Cases

- Search AI coding sessions across multiple tools with structured filters.
- Replay the full path from problem to solution.
- Group sessions by project or repository identity.
- Track and search file reads, edits, creates, deletes, and moves.
- View activity trends, model usage, token totals, and estimated cost.
- Keep session history local and private.

## Key Questions

### 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, Cursor, Kimi, Codex, and OpenCode into a project-aware engineering memory layer for recovering decisions, file activity, and complete collaboration paths.

### Which AI coding tools does CodeSesh support?

CodeSesh currently supports Claude Code, Cursor, Kimi, Codex, and OpenCode. Each tool connects through an agent adapter in the core package, then contributes sessions to unified lists, project browsing, structured search indexes, file activity, smart tags, token statistics, and full replay views.

### Does CodeSesh upload local AI session data?

CodeSesh runs on the user's machine and uses a local SQLite index with a local Web UI. Session content, file paths, token statistics, and cost estimates stay on the local computer, which suits developers who want ownership of AI coding context.

### How do you install and start CodeSesh?

The fastest way to start CodeSesh is running `npx codesesh` in a terminal. CodeSesh scans supported local AI coding sessions and opens the Web UI at `http://localhost:4521`; if that default port is busy, it automatically tries the next available port. The published CLI requires Node.js 18+; source development uses Node.js 22.12+ and pnpm 10+.

## Install

```bash
npx codesesh
```

CodeSesh opens a local Web UI at `http://localhost:4521`.

## Chinese Summary

CodeSesh 是一个本地开发者工具，用来发现、聚合、搜索和回放 Claude Code、Cursor、Kimi、Codex、OpenCode 等 AI 编码工具的本地历史会话，把分散的 AI 协作过程沉淀成按项目组织、可结构化检索、可复盘的工程记忆。