showagent MCP server

<!-- mcp-name: io.github.aytzey/showagent --> showagent

Switch coding agents. Bring the conversation. Find a local session and carry its user and assistant messages into another agent's native session format. Codex · Claude Code · Gemini CLI · OpenCode · jcode · Pi

Sample sessions; simulated CLI output. The handoff uses the real showagent binary; the target CLI is a labeled demo stub. See compatibility evidence for what has been tested.

Started debugging in Codex and want Claude's take? Find the old session, preview the handoff, then create a new Claude Code session in the same workspace. Your original session stays intact. Conversion carries transferable user and assistant messages; tool calls/results, approval state, attachments, and other agent runtime state are not carried over.

Install

On Linux or macOS, install the latest GitHub release. The script checks the archive against that release's SHA256SUMS and normally installs in ~/.local/bin:

curl -fsSL https://raw.githubusercontent.com/aytzey/showagent/main/scripts/install.sh | sh

If that directory is not on your PATH, run ~/.local/bin/showagent directly or add the directory to your shell's PATH.

On Windows, download and extract the windowsamd64.zip archive from the latest release, then run .\showagent.exe in PowerShell from the extracted directory. Windows support is experimental**; see platform and native-resume evidence.

Homebrew and Go installation remain available under other installation options. Distribution details explain version differences between channels.

Quick start

You need an existing local session, the target agent's CLI on PATH, and its normal sign-in/setup completed. Keep the original workspace available.

showagent

or latest user prompt. Press enter to finish searching, then select the session you want to continue.

1. Press / and search for the workspace or a phrase in the session's first

dropped. Press x again to write and select the new session.

1. Press o until the target is claude (or another installed agent).
2. Press x to review the workspace, message scope, and state that will be

1. Press enter to open that new session in the target CLI.

Prefer commands? The Codex → Claude handoff guide walks through selecting an explicit session ID, previewing, converting, and resuming it. It also explains the reverse direction and what conversion preserves.

Star showagent to keep it handy for your next agent switch.

Why

Each coding agent keeps its own local session store. showagent reads the supported stores and brings their sessions into one terminal picker:

Shortened. The full README is on GitHub.