Sessions, HAR and session packages
Every capture run is kept as a session. Browse them, reopen them, and move traffic in and out as HAR, CSV, OpenAPI or .wirelens packages.
Sessions#
Every time you start and stop capture, WireLens keeps that run as a session. Nothing is lost when you clear the traffic list or restart capture.
On the Mac, Sessions (⇧⌘S) opens a window that lists runs by date, Today, Yesterday, Previous 7 Days and earlier, with search, rename and delete. Select one to see its statistics, its traffic and the inspector, without touching what the main window is showing. You can also scope the main window to a single session, and go back with Show All Sessions.
Counts in a session are computed when you look, so a session always reports what it actually contains.
On iPhone, sessions are in the Traffic tab.
Session packages#
A .wirelens session package holds a capture with every header and body, in a single file you can archive, attach to a bug report or open on another Mac.
| Command | What you get |
|---|---|
| Export Session Package… (⇧⌘E) | The whole capture, bodies included |
| Export Session Package (Omit Oversized Bodies)… | Smaller, skipping the largest bodies |
| Export Redacted Session Package… | Credentials removed before the file is written |
| Open Session Package… (⇧⌘O) | Opens a package as its own session |
From iPhone, export a package and send it with AirDrop or Files. WireLens for Mac opens it as a session.
HAR#
HAR is the interchange format browsers and most debugging tools read.
- Export HAR… (⌘E) writes the current view. Export Selected Flow as HAR… writes one flow.
- Import HAR… (⌘O) opens a HAR file, such as one saved from a browser's developer tools, as a session you can inspect with every WireLens tool.
Other formats#
- CSV for spreadsheets: the whole view, or selected flows.
- cURL for a single request.
- OpenAPI, as YAML or a Swagger-style HTML page, describing the endpoints in a capture.
Coming from Charles#
Import Charles Session… opens a Charles session file, Convert Charles Session to HAR… turns one into a HAR, and Import Charles Settings… brings over your Charles tool settings.
Share with your team#
Share to Team Workspace… uploads the current view, a selection or a whole session as a link your team can open in a browser, with credentials redacted before anything leaves your Mac. See Team Workspace.
Settings backups#
Backup Settings… and Restore Settings… move your rules and preferences between Macs. Secrets inside rules are left out of a backup unless you choose to include them.
From the command line#
wirelens sessions
wirelens export har --out capture.har
wirelens export har --session <id> --out run.har
wirelens export csv --out capture.csv
wirelens export curl <flow-id>
Exports from the command line and MCP redact bodies and headers by default. Ask for secrets explicitly when you need the raw values.
Something here is unclear, or wrong for your setup? Contact support or write to support@wirelens.app.