Skip to main content

​
Sessions & HAR

Rockxy supports saving and restoring captured traffic in two formats: the native .rockxysession format for full-fidelity session files, and the industry-standard HAR (HTTP Archive) format for cross-tool compatibility.

​
Native .rockxysession Format

Rockxy’s native format preserves the full session including metadata, user annotations, and all captured transactions.

​
What .rockxysession Preserves

​
Saving a Session

  1. Capture traffic as usual.
  2. Choose File > Save Session… (Cmd+Shift+S).
  3. Pick a location and filename. Rockxy writes a .rockxysession file.
The file includes all captured transactions, log entries, user annotations (comments, highlight colors, pinned/saved status), and session metadata (capture date range, transaction count, Rockxy version).

​
Opening a Session

  1. Choose File > Open Session… (Cmd+O) and select a .rockxysession file.
  2. Rockxy shows an Import Review sheet with file metadata (name, type, request count, file size) and a warning if the current session is non-empty.
  3. Click Replace Current to load the session, or Cancel to abort.
  4. The loaded transactions appear in the traffic list with all annotations (comments, highlights, pins) restored. The status bar shows the import source.

​
HAR Format

HAR is a JSON-based format supported by browser DevTools, Charles Proxy, Proxyman, mitmproxy, and other network tools.

​
Importing a HAR File

  1. Choose File > Import HAR… (Cmd+Shift+I).
  2. Select a .har or .json file.
  3. Rockxy shows an Import Review sheet with file metadata and a destructive warning if you have an active session.
  4. Click Replace Current to import, or Cancel to abort.
  5. Imported transactions appear in the traffic list. The status bar shows the import source.
Import errors (invalid format, oversized file, deserialization failure) are shown in a dialog with a specific error message.

​
Exporting to HAR

  1. Choose File > Export HAR… (Cmd+Shift+E).
  2. An Export Scope sheet lets you choose what to export:
    • All Transactions — everything captured
    • Visible / Filtered — only what the current filter shows
    • Selected — only selected transactions
  3. Click Export… to open the save dialog.
  4. Pick a location and filename. Rockxy writes a standard HAR 1.2 file.
You can also export individual requests via right-click > Export > Export as HAR… in the request list.
Exported HAR files may contain request bodies, cookies, and authorization headers. Review exports before sharing.

​
Other Export Options

Beyond file-level session save/export, Rockxy supports copying individual requests in several formats via the right-click context menu:
  • Copy as cURL — ready-to-run cURL command.
  • Copy as Raw HTTP — full HTTP/1.1 text dump.
  • Copy as JSON — structured JSON representation.
  • Export as HAR… — save a single request as a .har file.

​
Limitations

  • HAR export includes HTTP transactions only. WebSocket frames, GraphQL metadata, log entries, and user annotations (comments, highlights) are not included in HAR files. Use .rockxysession for full-fidelity saves.
  • .rockxysession files are not compatible with other tools — use HAR for cross-tool sharing.
  • Bodies larger than 10 MB are truncated in .rockxysession files.
  • Large sessions with many transactions may take a few seconds to save or load.

​
Next Steps

Traffic Capture

How Rockxy captures HTTP, HTTPS, and WebSocket traffic.

Request Diff

Compare two captured transactions side by side.