Skip to main content
A conversation is a dashboard session running an agent in a terminal-backend pane. These commands find, inspect, and drive conversations from a shell instead of the dashboard UI.

pan conv

pan conversations is the full command name; pan conv is the alias everyone types. It scans your Claude Code session history into Overdeck’s own database, then lets you search, filter, resume, and manage those sessions and the pull requests linked to them.
Run pan conv <subcommand> --help for its options. The subcommands below take options worth knowing; every other subcommand’s options are in its --help.

pan conv list

pan conv show

pan conv resume

pan conv pull

pan conv current

pan conv search and pan conv enrich are described further in Search your conversations. pan conv cost summarizes estimated spend across the sessions pan conv scan has discovered on this machine; it is a different report from pan cost, which tracks actual Overdeck usage events across every project. See Conversations for search and scheduled runs in the dashboard. The dashboard’s Sessions page, which lists the sessions pan conv scan discovered, is behind Settings → Experimental → Experimental features.

pan handoff

Hand off a conversation to a new conversation that continues the work. Omit <conv> (or pass self) to hand off the conversation you are currently running in; any trailing text becomes the focus for the successor.
Focus is capped at 10,000 characters; keep it short and put a longer brief in a file the focus points at. A held handoff (--hold) waits with its kickoff unsent until you click Send in the dashboard, or run pan handoff start <conv> from a shell. See Handing off from the CLI.

pan fork

Summary fork a conversation: start a new session seeded with a generated summary of the source conversation’s work, instead of its full history. Omit <conv> to fork the conversation you are in. Pass --plain to skip the summary and copy the raw conversation history instead. pan fork needs a Claude Code session transcript, so it refuses conversations on other harnesses with “No session file found”; use pan handoff for those.

pan tell

Send a message to a running agent’s pane, or to a conversation on a linked machine addressed as @<machine>/<conv>.
See pan tell for targeting rules (issue id, agent id, conversation, bare number) and linked-machine addressing.

pan resume

Resume a stopped work agent, not a conversation: pan resume <id> restarts the saved harness session of an issue’s work agent, named by issue id or agent id. To resume a dashboard conversation instead, use pan conv resume <name>.
To recover a context-wedged agent with a summarized fresh session, use pan recover <id> --compact; pan resume --compact is refused because session rotation on resume is disabled. A paused, troubled, or session-less agent is refused with the reason. To start a session-less agent fresh in its workspace, use pan start <id>.

pan unarchive-conversation

Restore an archived conversation, found by its exact name first and then by a matching title.

pan open

Open a file, folder, or issue workspace in Overdeck’s dashboard, or in an external editor.
See Open in Overdeck for the full set of targets and editors.

pan share

Share a conversation by link: prints the join link and join code for a Shared Session.
See pan share for how the link and join code work.

Get help