showagent

showagent

Switch coding agents. Bring the conversation.

Out of Claude quota halfway through a fix? Want Codex to review what Gemini planned?

Started in Antigravity and want to finish in the terminal?

showagent finds every coding-agent session on your machine and continues it in another agent,

as that agent's own native session, in a few keystrokes.

Claude Code · Codex · Gemini CLI · Antigravity new · OpenCode · MiMoCode · Pi · jcode

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

or: brew install aytzey/tap/showagent

showagent

The demo runs the real showagent binary on sample sessions; the target CLI is a labeled stub. See compatibility evidence for what has been tested with real agents.

Why showagent

Every coding agent keeps its history in its own private format. Switching agents usually means starting over and re-explaining the task. showagent reads every supported store, puts all of your sessions in one picker, and moves a conversation between agents without leaving the terminal.

• Move conversations between agents. Eight agents, one picker. Hand a session from Claude Code to Codex, from Codex to Gemini CLI and back, or carry an Antigravity conversation into any of them.
• Native sessions, not copy-paste. The target agent gets a real session in its own store, so claude --resume, codex resume, gemini --resume, and the rest reopen it like any other session.
• Preview before anything is written. The first x shows the workspace, how many turns move, and what is dropped. Only the second x writes, and the original session is never modified.
• Find any past session. Group by workspace and fuzzy-search agent, session ID, paths, and first/latest prompts across every agent at once.
• Your agent can use it too. showagent mcp lets an MCP client search and read other agents' history, and request a hand-off.
• Bring web chats in. Import a public ChatGPT or Claude share link, a transcript file, or pasted text as a native coding-agent session.
• Local only. No hosted service, telemetry, or account. See the privacy FAQ.

Typical hand-offs

Quick start

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

showagent

1. Press / and search for the workspace or a phrase in the session's first or latest user prompt. Press enter to finish searching, then select the session you want to continue.
2. Press o until the target is claude (or another installed agent).
3. Press x to review the workspace, message scope, and state that will be dropped. Press x again to write and select the new session.
4. 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.

If showagent saved you a re-explanation, a ⭐ helps other people find it.

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 windows_amd64.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.

Supported agents

Notes:

• The table describes implemented adapters, not a claim that every provider version and conversion direction has passed a real CLI test. See the compatibility record.
• Antigravity has two surfaces. Conversations from the agy terminal agent are listed with their workspace and reopen with agy --conversation . Conversations from the Antigravity IDE are listed as hand-off sources: convert them into any other supported agent. showagent reads the plain-text transcript Antigravity keeps next to each conversation and never opens Antigravity's private databases. Converting *into* Antigravity is not available yet: agy has no way to create a conversation without a model turn, and in that turn the model can write files if the handed-off text asks it to. showagent will add this direction when agy offers a safe import path.
• OpenCode and MiMoCode store sessions in a SQLite database, so every operation (discover, export, import, delete) goes through their own CLI; showagent never writes into the database directly. OpenCode, MiMoCode and jcode only appear when their CLI is installed.
• The picker only offers hand-off targets whose CLI is on PATH. Scripted conversion to file-backed agents can still prepare a session before their CLI is installed; OpenCode and MiMoCode always require their CLI because the import goes through the agent itself.
• jcode is a niche, experimental agent CLI. Its support is auto-hidden: if no jcode binary is on PATH, showagent never shows it.
• Pi sessions are versioned JSONL trees. showagent follows Pi's active leaf through parentId links, so abandoned branches are not previewed or moved into another agent. Converted sessions use Pi's native v3 format; the compatibility record distinguishes file conversion from native loader and model-continuation checks.
• A project-local Pi sessionDir is visible when showagent is launched from that project. Like Pi itself, showagent cannot discover arbitrary custom session roots belonging to other projects unless one is selected globally with PI_CODING_AGENT_SESSION_DIR.
• Platforms: Linux and macOS (amd64 + arm64). Windows (amd64) builds are released but experimental: resume runs the agent as a child process instead of replacing showagent.

Other installation options

# Homebrew (Linux/macOS)

brew install aytzey/tap/showagent

Go 1.26.10+

go install github.com/aytzey/showagent/cmd/showagent@latest

Homebrew, GitHub releases, Go module versions, and MCP bundles can update on different schedules. Go's @latest follows module version resolution, which can differ from GitHub's latest release; check showagent --version and showagent --help after installing. See distribution details for channel-specific features and update instructions.

Archives are also available for linux/darwin amd64 + arm64 and windows amd64 (experimental) on the releases page.

More commands

showagent                  # open the interactive picker

showagent list # plain table of every session showagent list --json # the same, machine-readable showagent transcript latest --max-turns 50 --json

bounded, secret-redacted context for local handoff

showagent resume latest # reopen the most recent session, any agent showagent convert SOURCE_SESSION_ID --to claude --dry-run

preview exactly what a hand-off would carry/drop

showagent import --url CHAT_SHARE_URL --to codex --cwd ./my-project

create a native coding-agent session from a public web chat

showagent import --file conversation.txt --into codex:EXACT_SESSION_ID

add text to an existing Codex session's context

showagent info latest # exact resume command + storage location showagent mcp # serve session history to MCP-capable agents (stdio) showagent mcp --read-only # same search/transcript tools, without tools that write copies showagent mcp --allow-secrets

explicitly allow verbatim secret-like transcript values

showagent update # update a standalone install (Homebrew: brew upgrade aytzey/tap/showagent) showagent --help # full CLI help

Replace SOURCE_SESSION_ID with the ID you selected from showagent list. The transcript command is not present in older builds such as v0.11.0; check distribution details if your help output differs. See web conversation import for accepted transcript formats, security boundaries, and the difference between creating a session and adding context to an existing one.

Keybindings

| space | Collapse or expand the selected workspace gro