sesh
Read-only MCP server and CLI to browse and move past sessions across coding agents
sesh is an open-source MCP server for agent tooling. It runs locally on your machine and is started by your AI client.
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add sesh -- docker run -i --rm ghcr.io/rojinebrahimi/sesh:0.2.0Add to claude_desktop_config.json
{
"mcpServers": {
"sesh": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/rojinebrahimi/sesh:0.2.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"sesh": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/rojinebrahimi/sesh:0.2.0"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"sesh": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/rojinebrahimi/sesh:0.2.0"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sesh": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/rojinebrahimi/sesh:0.2.0"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"sesh": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/rojinebrahimi/sesh:0.2.0"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
About sesh
The README says sesh reads session histories from Claude Code, OpenAI Codex CLI, OpenCode and omp/pi and converts them into a shared append-only JSONL format called Open Session Protocol. Once normalised, a session can be listed, inspected, validated, checkpointed and written back into another agent's format, so work started in one coding agent can be picked up in another.
Running it as an MCP server lets an agent look up earlier sessions through read-only tools such as list, inspect, read, checkpoint and search. The README states that it runs locally and sends nothing out, and that reads never modify the source agents' data. Writes only add a new session and never overwrite an existing one.
The project is aimed at developers who switch between coding agents and want to carry context across them. Its own status table flags that write-back to Claude Code, Codex and omp/pi has only been checked against documented formats, with OpenCode the only target tested in its real CLI.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- sesh_list
- List sessions across supported agents.
- sesh_inspect
- Summarise a session and its active branch.
- sesh_read
- Read transcript content from a session.
- sesh_checkpoint
- Produce a handoff checkpoint for a session.
- sesh_search
- Search across past sessions.
What it does
- Cross-agent session conversion
- Converts sessions from one supported coding agent into another's format, keeping the active branch and text.
- Branch-aware history
- Keeps abandoned branches in the OSP file while replaying only the live path when resuming.
- Session validation
- Checks sessions for errors and warnings, with a command to validate every session on the machine.
- Deterministic checkpoints
- Produces handoff notes listing goal, files touched and next steps without calling a model, with an optional summarizer hook.
- Read-only MCP server
- Exposes list, inspect, read, checkpoint and search tools to MCP clients such as Claude Code and Codex.
- Single static binary
- Distributed as a Go binary with no CGO, with prebuilt releases for Linux, macOS and Windows.
Good for
- Continue a half-finished task in a different coding agent
- Let an agent search and recall earlier coding sessions
- Archive and inspect local agent session logs in a neutral format
- Create a short handoff checkpoint instead of copying full chat history
Pricing
Open source
Open source under Apache-2.0; no paid plan mentioned.
sesh FAQ
Does sesh modify my agents' session data?
The README says reads never modify agents' data and writes only ever add a new session.
Does the MCP server send data off the machine?
The README states it runs on your machine and sends nothing out.
Which agents can sesh read?
Claude Code, OpenAI Codex CLI, OpenCode and omp/pi. The README notes omp was not tested against real sessions.
How do I install sesh as an MCP server?
The README gives commands to add it to Claude Code and Codex with the sesh mcp command, and says it is also published to the official MCP Registry as a Docker image.
Is sesh free?
Yes. sesh is open source, so you can use and self-host it for free.
How do I add sesh to Claude Code?
Run this command in your terminal: claude mcp add sesh -- docker run -i --rm ghcr.io/rojinebrahimi/sesh:0.2.0
What are the best alternatives to sesh?
The closest alternatives to sesh are Seamless, databasedmcp, OpenCrawl, World Model MCP and Subagent MCP.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.