Sensitive Browser

Execute sensitive browser actions securely by delegating credential handling, payments, and form filling to a dedicated subprocess with isolated context.

When to Use

• User asks to log into a website with credentials
• User needs to fill payment information on a checkout page
• User needs to complete forms with personal/sensitive data
• Browser automation requires authentication handoff

Prerequisites

The ATXP_CONNECTION environment variable must be defined for LLM access. This provides the connection string to the ATXP platform.

If not configured, see the ATXP CLI for setup instructions.

Workflow

1. Prepare Sensitive Data File

Create a JSON file with the user's sensitive data. Ask the user for the values needed:

{
  "credentials": {
    "username": "user@example.com",
    "password": "secret"
  },
  "payment": {
    "cardNumber": "4111111111111111",
    "expiry": "12/28",
    "cvv": "123",
    "billingZip": "94102"
  },
  "personal": {
    "fullName": "Jane Doe",
    "phone": "+1-555-0123",
    "address": "123 Main St"
  }
}

Only include the fields needed for the task. Store securely and delete after use.

2. Execute the Sensitive Action

npx sensitive-browser "<task>" \
  --sensitive-data ./creds.json \
  --url <target-url> \
  --state ./session.json \
  --output ./session.json

Options:

Option	Description
<task>	Natural language task (e.g., "log in with credentials")
-d, --sensitive-data <path>	Path to sensitive data JSON (required)
-u, --url <url>	Target URL to navigate to
-s, --state <path>	Playwright storage state to load
-o, --output <path>	Output path for updated state

3. Integration with agent-browser

When used with agent-browser, hand off session state:

# Save current session
agent-browser --session myapp state save ./session.json

# Hand off to sensitive-browser for login
npx sensitive-browser "log in with credentials" \
  --state ./session.json \
  --sensitive-data ./creds.json

# Resume agent-browser with authenticated session
agent-browser --session myapp state load ./session.json

Security Notes

• Sensitive data values are never logged or displayed
• The tool shows which fields will be used, not their values
• Delete sensitive data files after use
• Consider environment variables or secret managers for production

Sensitive Data Schema

Supported field categories:

• credentials: username, password, email
• payment: cardNumber, expiry, cvv, billingZip, cardholderName
• personal: fullName, firstName, lastName, phone, address, city, state, zip, country, dateOfBirth
• Custom fields: Any additional key: value pairs as needed