heymcp sessions - HeyMCP

heymcp sessions

Column-aligned rows of your recent tunnels — which are live, which have closed, and which have aged out of your retention window. Useful for two things in particular: finding a session id to export, and seeing what’s holding your concurrent tunnel slots when a heymcp share gets refused.

Reading the output

Each row shows the session’s status, its slug, when it opened, and its activity.

Status	Meaning
`live`	Connected right now.
`closed`	Finished. History still readable.
`expired`	Past your retention window — the row remains, the events are gone.

Scripting

heymcp sessions --json

Emits {"sessions": [...]}. It exits 0 whether or not there are any — with none, the human-readable form prints “no sessions yet” instead of a table.

heymcp sessions --json | jq -r '.sessions[0].id'

heymcp export — take a session’s history with you
Sessions and history — what the states mean and how long things live

⌘I