session-migrate: developer tool for Hermes Agent

session-migrate

xhluca/session-migrate

CLI that moves coding agent sessions between 18 harnesses, including Hermes Agent

In short

session-migrate is a Python CLI that converts and moves coding-agent sessions between harnesses, with Hermes Agent among the listed ones. It lets you continue a Claude Code session in Codex or Pi.

What session-migrate does

session-migrate reads native session transcripts and writes them in another agent's format. The README lists Claude Code, Codex, Pi, Oh My Pi, OpenCode, GitHub Copilot CLI, Antigravity CLI, Cursor Agent, Mistral Vibe, Muse Code, Qwen Code, Kimi Code, Grok, Kilo Code, OpenHands, Hermes Agent, MastraCode and Devin.

The command smigrate inspect shows a transcript without printing the conversation. smigrate transfer moves a session by ID or title between two harnesses, and you then resume it with the target agent from the same project directory. A catalog refresh and search finds older sessions by native title, name or ID, with filters such as format, lifecycle and date. Search covers titles, not conversation bodies, and refresh stays within known roots. Linux and Python 3.11+ are currently supported.

Key features

Transfer between 18 agent harnesses
Inspect a transcript without printing it
Catalog search by title, name or ID
Filters for format, lifecycle and date
smigrate shorthand command
Prompt for your own coding agent to run it

When to use it

Continuing a Claude Code session in Hermes Agent
Finding an old session by its title
Switching tools without losing context

Who it is for: Developers who use more than one coding agent and want to carry sessions across.

How it fits with Hermes Agent

It lists Hermes Agent among the harnesses it can migrate sessions to and from, as one of 18.

How to install session-migrate

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

curl -LsSf https://session-migrate.github.io/install.sh | sh
uv tool install session-migrate

Requirements: Python 3.11+ and Linux

FAQ

What is session-migrate?

session-migrate is a Python CLI that migrates coding-agent sessions between 18 harnesses, such as Claude Code, Codex, Pi and Hermes Agent.

Does session-migrate work with Hermes Agent?

Yes. Hermes Agent is on the README's list of supported harnesses for session migration.

How do I install session-migrate?

Run the install script with curl, or use uv tool install session-migrate. pipx install session-migrate also works.