showagent: move sessions between AI agents
showagent
A CLI with a TUI that finds Claude Code, Codex and Gemini CLI sessions and continues them in another agent as native ones
- 63 ★ on the repository
- Last commit
Extended access
Why this level
- The program reads the local stores of all your agents, including prompt history and project paths
- Transcripts through MCP reach the model provider, and the --allow-secrets flag removes secret scrubbing
Install
- Works in
Manual install
brew install aytzey/tap/showagentHomebrew install. The showagent command opens the session picker.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The program reads the local stores of all your agents, including prompt history and project paths
- Transcripts through MCP reach the model provider, and the --allow-secrets flag removes secret scrubbing
This is third-party code. Review the repository files before installing.
What it does
Every coding agent keeps its history in its own format, so switching agents usually means re-explaining the task. showagent reads the stores of all supported agents, gathers sessions in one picker and moves a conversation between them without leaving the terminal. It supports Claude Code, Codex, Gemini CLI, Antigravity, OpenCode, MiMoCode, Pi and jcode. The target agent gets a real session in its own store, and a usual claude --resume or codex resume opens it. Before writing, a preview shows the workspace, how many turns move and what is dropped. Only the second x press writes, and the original session is never modified. Search covers workspace, session ID and the first and last prompts. The showagent mcp command starts a local MCP server where an agent finds sessions, reads recent turns and requests a copy in another agent. A public ChatGPT or Claude share link can be imported as an agent session.
Who it is for. Developers who work with several coding agents and want to continue a started task in another without re-explaining.
Good fit when
- One agent hit its limit mid-task and you want to continue in another
- You want a second opinion on a bug: a Codex session should go to Claude or Gemini CLI
- You want to continue an Antigravity IDE conversation from a terminal
- You need to find an old session by a phrase from a prompt and open it in the agent that wrote it
- You want to try another direction from a session branch without touching the original
Not a fit when
- You need search across every message: search covers the workspace and first and last prompts
- The agent must not write session copies: start showagent mcp with the --read-only flag
- You need a transfer between machines or the cloud: the tool is local only
Example request
Find the Codex session whose first prompt mentioned rate limiting, read its last turns and give me the command to continue in Claude Code.Limitations
You need an existing local session, the target agent CLI on PATH and its sign-in completed. Some turns are dropped in a transfer, the preview shows them, and verified agent pairs are described in docs/compatibility.md. Antigravity IDE sessions can only be handed off and cannot be reopened. Installation uses a curl script or Homebrew, and the script is worth reading before running. MCP transcripts are scrubbed of secrets by default, and the --allow-secrets flag removes scrubbing and sends values to the model provider.
How to disable. If installed through Homebrew run brew uninstall showagent, and for the script install delete the binary from the install folder. Remove the MCP entry with claude mcp remove showagent. Created session copies live in the target agent stores.
FAQ
Which agents are supported?
Claude Code, Codex, Gemini CLI, Antigravity, OpenCode, MiMoCode, Pi and jcode. For Antigravity IDE the transfer works one way, from it into terminal agents.
Is the original session changed?
No. Transfer and branching only add new sessions and the original stays as is. Writing happens after the second x press on the preview screen.
Does the program send data over the network?
The program does not upload sessions, send telemetry or need an account. An MCP client may send transcripts to its model provider, so secrets in them are scrubbed by default.
Which tools does the MCP server have?
list_sessions, get_transcript, get_user_messages, branch_session, convert_session and resume_command. There is no delete, and resume_command only returns a command without running it.
How do I import a web chat?
Provide a public ChatGPT or Claude share link, a transcript file or pasted text and it becomes a coding agent session. Private chats and browser cookies are not used.
Discussion
No questions or reviews yet.
Related
CLI toolsA tmux-based TUI that runs Claude Code, Codex and other agents in one list: status, quick prompts, worktrees and diff review
Agents Can Communicate (ACC)
Agents Can Communicate
ACC passes questions, reviews and handoffs between Claude Code, Codex and other client sessions on one machine
A CLI that moves sessions between 18 coding agents, including Claude Code, Codex, Cursor and OpenCode, so work can continue
continues carries a session from Claude Code, Codex, Cursor and 13 other agents into any other one, with messages, file edits and commands in tow
Mjolnir runs Claude Code, Codex and other agent sessions in a terminal, in containers and over SSH, and keeps them running.
The casr utility moves a coding agent session to another provider: converts it and prints the resume command.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| showagent: move sessions between AI agents (this card) | no | 63 | |
| session-migrate | no | 176 | session migration between agents from the command line, without a picker or MCP |
| Coding Agent Session Search (cass) | no | 1,205 | search across agent sessions, no transfer into another agent |
README in short
The README explains why session transfer is needed, shows typical hand-offs between agents with keys and a four-step quick start. It covers MCP mode and sections on privacy, updates and compatibility.