Skip to main content
Writes a session’s history to stdout. Get the id from heymcp sessions or from the inspector URL.
Export reads from stored history, so it only works while the session is within your retention window — 24 hours on Hobby, 7 days on Pro. An expired session exports nothing.

​
Options

​
default:"json"
Which shape to write.
​
Write to a file instead of stdout.

​
The json format

Everything, losslessly. The full session metadata plus every raw event in arrival order:
Requests and responses appear as separate events, exactly as they arrived. That’s precisely why they’re stored separately — the inspector folds them together for reading, but an export that folded them would lose information. Use this when you want the whole picture: a bug report, an archive before a session expires, or your own analysis.

​
The vizra format

Deliberately narrow: ordered tool calls with their arguments, results and the client that made them. Enough to replay a session deterministically, and nothing else.
ok is null when no result was ever paired to the call — the agent asked and nothing came back. Use this when you’re turning real agent behaviour into an evaluation fixture. The interesting property is that the arguments are what a real model actually sent, not what you imagined it would send.

​
A worked use

The classic one. An agent breaks your tool by sending "7pm" for a date:
Now that failure is a regression test, and it’s a failure a human wouldn’t have thought to write.