Skip to main content
Glama
Sign In
session-convert

session-convert

by megamen32
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

session-convert

Move an AI coding session between Claude Code, Codex CLI, and OpenCode without losing the conversation.

Docs · Conversion reference · Русский

session-convert data flow

When the useful context is in the wrong coding agent, session-convert reads the source session, maps it to a common conversation, and writes the target agent's native JSONL or SQLite format. It is an MCP server for local, user-owned session files—not a hosted sync service.

What it does

  • Converts all six directions between Claude Code, Codex CLI, and OpenCode.

  • Reads Claude/Codex JSONL and current or legacy OpenCode SQLite layouts.

  • Preserves text, tool calls/results, reasoning where available, images, metadata, and model names.

  • Previews message counts, tool activity, and compatibility notes before writing.

  • Also exposes a direct-path conversion API for known .jsonl or .db files.

Related MCP server: pacifico

Install from source

There is no published package install documented here yet. For a source checkout, use Node.js 20+ and run:

git clone https://github.com/megamen32/session-convert.git
cd session-convert
npm ci
npm run build

Then point your MCP client at dist/index.js:

{
  "mcpServers": {
    "session-convert": {
      "command": "node",
      "args": ["/absolute/path/to/session-convert/dist/index.js"]
    }
  }
}

First conversion

Use list_sessions to find a session, preview_conversion to inspect the mapping, and convert_session to write it. convert_by_path is available when you already know the source file. The server accesses local session files using the permissions of the MCP client.

Learn more

License

MIT

Available Tools

4 tools
convert_by_pathA

Convert a session file by its direct file path. Auto-detects the format (Claude JSONL, Codex rollout JSONL, or OpenCode .db). Useful when you know the exact file location.

Inputs: to (required), sourcePath (required), projectPath.

convert_sessionB

Convert a session from one harness to another. Reads the session, transforms messages to the target format, and writes it to the target harness's native storage. OpenCode conversion (read/write) is uniquely supported — no other tool does this.

Inputs: to (required), from (required), sessionId (required), projectPath, +1 more.

list_sessionsA

List convertible sessions from a harness. Shows session ID, title, CWD, model, message count, and age. Use this to find the session ID to convert.

Inputs: harness (required), cwdPrefix, searchPaths.

preview_conversionA

Preview what a session conversion would look like without actually writing anything. Shows message breakdown, tool call stats, and compatibility notes for the target format.

Inputs: to (required), from (required), sessionId (required), searchPaths.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: listing sessions, converting by session ID, previewing conversions, and converting by file path. There is no overlap or ambiguity between them.

    Naming Consistency4/5

    All tools use snake_case with a verb_noun pattern. The two convert tools differ by the argument (session vs path), which is consistent but could be slightly confusing. Overall, naming is predictable and well-structured.

    Tool Count5/5

    With 4 tools, the set is well-scoped for session conversion. Each tool serves a necessary function: listing, converting by ID, previewing, and converting by path. No unnecessary tools and no missing essential operations.

    Completeness5/5

    The tool set covers the full conversion workflow: discovering sessions (list_sessions), previewing before conversion (preview_conversion), and converting via two methods (by session ID or by file path). No obvious gaps for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • pacifico

      emersoftware
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables local archiving and searchable recall of AI coding sessions from Claude Code, Codex, Pi, and OpenCode via MCP, allowing agents to access past conversations as context.
      2
      MIT

    • agent-config-bridge

      onehumanbeing
      A
      license
      A
      quality
      B
      maintenance
      Enables converting and migrating coding-agent instruction files and MCP server configurations between Claude Code, Codex CLI, Cursor and Gemini CLI, with read-only detection of existing configs, dry-run project migration, and a doc-linked compatibility matrix. Runs locally over stdio with no network calls or telemetry, writing files only when explicitly requested.
      5
      MIT

    • claude-memory-manager

      NyxToolsDev
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Code sessions to automatically capture and retrieve architectural decisions, code changes, bug fixes, and configuration context across sessions using local SQLite storage and hybrid semantic/keyword search.
      79 PyPI
      1
      MIT