Wraith Browser

Session Management

Named browser sessions with independent cookies, history, and page state

Session management tools let you run multiple browser instances simultaneously. Each named session has its own cookie jar, browsing history, and page state. You can switch between sessions to work on different tasks in parallel. Requires the cdp feature flag.

Tools

ToolDescriptionKey Parameters
browse_session_createCreate a new named browser sessionname (required), engine_type
browse_session_switchSwitch the active sessionname (required)
browse_session_listList all open sessions with engine type and URL(none)
browse_session_closeClose a session and shut down its enginename (required)

Examples

Work with multiple sessions

{
  "tool": "browse_session_create",
  "arguments": {
    "name": "linkedin",
    "engine_type": "cdp"
  }
}

Creates a new session backed by Chrome (CDP). You can also use "native" for the Sevro engine. Switch between sessions:

{
  "tool": "browse_session_switch",
  "arguments": {
    "name": "linkedin"
  }
}

All subsequent browse_* commands route to the switched session's engine. The "native" session always exists and cannot be closed. If you close the active session, it auto-switches back to "native".

List active sessions

{
  "tool": "browse_session_list",
  "arguments": {}
}

Returns all open sessions with their engine type (native Sevro or CDP Chrome) and current URL. Available even without the cdp feature flag.

On this page