showagent — Claude Code MCP server: features and setup
Search local coding-agent sessions and carry a conversation into another agent. Handy when a task needs to move to a different CLI.
Open on GitHubWhat showagent does
showagent brings sessions from supported agents into one searchable list. Find them by workspace or text from a prompt, then hand a conversation to another agent. Its MCP mode lets a client search and read other agents’ histories and request a hand-off.
Before a hand-off, the tool displays the workspace, how much of the conversation will move, and which state will be left behind. The write happens on the second press of x; the source session stays unchanged. The receiving agent gets a session in its own format.
You need a saved local conversation, the target agent’s CLI on PATH, an active sign-in, and access to the original workspace. Without that CLI, the selected agent cannot open the transferred conversation.
What it helps with
- find an earlier session by workspace or prompt text
- continue a Claude Code conversation in Codex or Gemini CLI
- create a session in the receiving agent’s format
- search another agent’s history through an MCP client
Example prompts for the agent
- Find a session by a phrase from my prompt and prepare a hand-off to Codex.
- Show conversations from this workspace so I can continue one in Gemini CLI.
- Use MCP to find a Claude Code session by prompt text and request a hand-off to Codex.
How to install showagent
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about showagent
How do I install showagent for Claude Code?
On Linux or macOS, run curl -fsSL https://raw.githubusercontent.com/aytzey/showagent/main/scripts/install.sh | sh, then launch showagent. Start its MCP mode with showagent mcp.
What does showagent do?
It gathers local sessions from supported coding agents so you can search them and move a conversation to another agent. MCP clients can also search and read those histories.
What is needed to hand off a session?
Have a saved local session, the receiving agent’s CLI on PATH, an active sign-in, and access to the original workspace.
