Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

docs: add network export to endpoints and commands references

Aria6dc6dd7cd8a1
diff --git a/docs/commands.md b/docs/commands.md
index e262ae3a..5d89e17e 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -116,6 +116,11 @@ pinchtab network # List captured network requests
pinchtab network <requestId> # Show one request in detail
pinchtab network --stream # Stream network entries
pinchtab network --clear # Clear captured network data
+pinchtab network-export # Export as HAR 1.2 (saved to exports/)
+pinchtab network-export -o session.har # Export to specific file
+pinchtab network-export --format ndjson # Export as NDJSON (one entry per line)
+pinchtab network-export --body # Include response bodies
+pinchtab network-export --stream -o l.har # Live capture to file while browsing
pinchtab dialog accept [text] # Accept alert/confirm/prompt
pinchtab dialog dismiss # Dismiss dialog
pinchtab console # Show console logs
@@ -222,6 +227,7 @@ Commands with `--tab` currently include:
- `keyup`
- `scrollintoview`
- `network`
+- `network-export`
- `wait`
- `dialog accept`
- `dialog dismiss`
diff --git a/docs/endpoints.md b/docs/endpoints.md
index e51520c4..938eb56e 100644
--- a/docs/endpoints.md
+++ b/docs/endpoints.md
@@ -229,10 +229,14 @@ POST /wait
POST /tabs/{id}/wait
GET /network
GET /network/stream
+GET /network/export
+GET /network/export/stream
GET /network/{requestId}
POST /network/clear
GET /tabs/{id}/network
GET /tabs/{id}/network/stream
+GET /tabs/{id}/network/export
+GET /tabs/{id}/network/export/stream
GET /tabs/{id}/network/{requestId}
POST /dialog
POST /tabs/{id}/dialog
@@ -260,6 +264,17 @@ Network query parameters:
- `bufferSize`
- `body=true` on detail requests
+Network export query parameters:
+
+- `format` — `har` (default) or `ndjson`. Pluggable: new formats register at startup.
+- `output=file` — save to disk instead of streaming to response
+- `path` — filename when `output=file` (auto-generated if omitted, required for `/export/stream`)
+- `body=true` — include response bodies (fetched on demand, 10 MB cap per entry)
+- `redact` — `true` (default) redacts Cookie/Authorization/Set-Cookie. `false` exports raw headers.
+- all standard network filters (`filter`, `method`, `status`, `type`, `limit`)
+
+The `/export` endpoint returns the full capture as a single response. The `/export/stream` endpoint writes entries to a file as they arrive (SSE progress events sent to the caller). The streamed file is atomically renamed on completion.
+
Dialog body fields:
- `action`: `accept` or `dismiss`