walidboulanouar

walidboulanouar / session-porter

Public

Move AI coding sessions between Claude Code and Codex CLI

13
0
100% credibility
Found May 19, 2026 at 16 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Session Porter is a free, local-only tool that helps you move AI coding conversations between Claude Code and Codex CLI. It reads your saved sessions from either tool, converts them into a format the other tool understands, and writes them so you can continue working seamlessly. The tool runs entirely on your computer without needing any internet connection or special passwords. It supports different transfer modes depending on how much context you want to bring over, and includes helpful commands for browsing, searching, and summarizing your past sessions.

How It Works

1
🤖 You've been working with Claude Code

You've built up a helpful conversation with your AI coding assistant and want to continue the work in a different tool.

2
📋 You browse your saved sessions

You open session-porter and see a list of all your past conversations, sorted by date, so you can find the one you want to continue.

3
🔍 You preview a session before moving it

You check the session summary to see what was discussed, what files were worked on, and how many messages are included.

4
🔄 You transfer the session to Codex

With one command, your conversation is converted and saved into Codex's format, ready to continue from where you left off.

5
You choose how much context to include
📝
Compact mode

A brief summary plus your conversation — perfect for quick context

📚
Full mode

Everything including all the details about file changes and tool usage

🎯
Resume-only mode

Just a short reminder of what you were doing — lightest option

6
🚀 You continue working in Codex

You launch Codex and pick up right where Claude Code left off, with full awareness of your previous work.

✨ Your work continues seamlessly

You've successfully moved a coding session between tools without losing any context, and your project keeps moving forward.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 16 to 13 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is session-porter?

session-porter is a TypeScript CLI tool that moves AI coding sessions between Claude Code and Codex CLI without losing context. Both tools store conversation history as JSONL files locally, and this bridge reads, normalizes, and converts between them. You can start a project in Claude Code, then continue it in Codex (or vice versa) with full awareness of what was already done. It runs entirely offline with no cloud service and no API keys required.

Why is it gaining traction?

The hook is vendor independence. If you've ever been locked into one AI coding assistant and wished you could switch, this solves that. The tool supports multiple transfer modes -- raw conversation, full history with context, compact handoff, or just a resume brief -- letting you control how much context gets carried over. It also normalizes tool calls across agents using a universal taxonomy, so file edits, shell commands, and searches translate consistently. A built-in handoff generator produces continuation prompts you can paste into any agent, even ones without native adapters. The architecture uses an adapter pattern, making it extensible if you want to add support for other AI coding tools later.

Who should use this?

Developers evaluating Claude Code versus Codex CLI will find this useful for side-by-side comparison without starting from scratch each time. Teams working across different AI assistants can share session context more easily. If you've ever wanted to switch tools mid-project but couldn't afford to lose your conversation history, this is for you. Researchers studying AI coding behavior across tools could also benefit from the export functionality, which outputs sessions as JSON or markdown.

Verdict

At 13 stars with a 1.0% credibility score, this is an early-stage, niche utility -- useful if you specifically need cross-tool session portability, but not yet battle-tested by a large community. The documentation is solid and the MIT license is clear, but test coverage is minimal and adoption is low. Try it if your workflow genuinely requires moving between Claude Code and Codex CLI; otherwise, wait for broader community validation.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.