State

pinchtab state shows the current full browser state for a tab, and also manages saved browser state on disk.

There are two related state views:

  • full browser state via pinchtab state or GET /state
  • live tab state via GET /tabs/{id}/state
  • current-origin storage via pinchtab storage ...

Full browser state includes:

  • cookies
  • current-origin localStorage
  • current-origin sessionStorage
  • optional metadata

All full/saved state operations require security.allowStateExport=true.

Commands

terminal 
pinchtab state [--tab <id>]pinchtab state listpinchtab state save [--name <name>] [--encrypt] [--tab <id>]pinchtab state load --name <name-or-prefix> [--tab <id>]pinchtab state show --name <name>pinchtab state delete --name <name>pinchtab state clean [--older-than <hours>]
pinchtab state [--tab <id>]pinchtab state listpinchtab state save [--name <name>] [--encrypt] [--tab <id>]pinchtab state load --name <name-or-prefix> [--tab <id>]pinchtab state show --name <name>pinchtab state delete --name <name>pinchtab state clean [--older-than <hours>]

Show Current Browser State

terminal 
pinchtab statepinchtab state --tab <tabId>
pinchtab statepinchtab state --tab <tabId>

Returns the current full browser state for the active tab or the specified tab:

  • cookies
  • current-origin storage
  • tab information such as tabId, URL, and title
  • metadata such as origin and user agent

Use this when you need the richer gated state view. For the lightweight operational/readiness view, use GET /tabs/{id}/state.

List Saved States

terminal 
pinchtab state list
pinchtab state list

Lists saved state files in the configured state directory.

Save Current Browser State

terminal 
pinchtab state savepinchtab state save --name work-loginpinchtab state save --name checkout --tab <tabId>pinchtab state save --name work-login --encrypt
pinchtab state savepinchtab state save --name work-loginpinchtab state save --name checkout --tab <tabId>pinchtab state save --name work-login --encrypt

Notes:

  • omitting --name lets PinchTab auto-generate one
  • --tab <id> captures state from a specific tab instead of the active/current one
  • --encrypt requires the configured state-encryption key

Load A Saved State

terminal 
pinchtab state load --name work-loginpinchtab state load --name work-log    # prefix match, newest match winspinchtab state load --name checkout --tab <tabId>
pinchtab state load --name work-loginpinchtab state load --name work-log    # prefix match, newest match winspinchtab state load --name checkout --tab <tabId>

Notes:

  • --name accepts either an exact name or a prefix
  • prefix matching resolves to the most recent matching saved state
  • loading restores cookies plus current-origin storage into the target tab

Show Saved State Details

terminal 
pinchtab state show --name work-login
pinchtab state show --name work-login

Displays the full saved browser state record, including stored metadata and origin storage payloads.

Delete A Saved State

terminal 
pinchtab state delete --name work-login
pinchtab state delete --name work-login

Removes the named state file from disk.

Clean Old Saved State Files

terminal 
pinchtab state cleanpinchtab state clean --older-than 72
pinchtab state cleanpinchtab state clean --older-than 72

Removes saved state files older than the given number of hours. Default is 24.

HTTP API

GET    /state
GET    /state/list
GET    /state/show
POST   /state/save
POST   /state/load
DELETE /state
POST   /state/clean

See Endpoints for the short route index. Use GET /state?tabId=<id> for the full gated browser-state view and GET /tabs/{id}/state for live readiness/blocking data.

  • Tabs for live tab work and --tab <id>
  • Sessions for agent/session auth
  • Config for security flags and storage directories