Session Recording¶

Capture browser actions for replay and analysis.

Start Recording¶

# Begin new session
domguard session start

# Named session
domguard session start --name "checkout-flow"

Check Status¶

domguard session status

Shows: - Session ID - Start time - Number of actions recorded

Stop Recording¶

domguard session stop

Saves the session to .domguard/sessions/.

Managing Sessions¶

List Sessions¶

domguard session list

View Session Details¶

domguard session show <session-id>

Shows step-by-step action log with: - Timestamp - Action type - Target element - Parameters

Export Session¶

domguard session export <session-id> -o session.json

Delete Session¶

domguard session delete <session-id>

Session Format¶

Sessions are stored as JSON with:

{
  "id": "session-abc123",
  "name": "checkout-flow",
  "created": "2025-01-15T10:30:00Z",
  "actions": [
    {
      "timestamp": "2025-01-15T10:30:01Z",
      "type": "navigate",
      "url": "https://shop.example.com"
    },
    {
      "timestamp": "2025-01-15T10:30:05Z",
      "type": "click",
      "selector": "button.add-to-cart"
    },
    {
      "timestamp": "2025-01-15T10:30:08Z",
      "type": "type",
      "selector": "input#email",
      "text": "user@example.com"
    }
  ]
}

Use Cases¶

Debugging - Replay issues step-by-step
Testing - Create test cases from manual exploration
Documentation - Record workflows for training
Automation - Convert sessions to reusable workflows