Reference

Configuration

Full reference for config.toml, environment variables, and every setting Pagerunner supports.

Config File Location

Default: ~/.pagerunner/config.toml

Override with:

terminal
PAGERUNNER_CONFIG_PATH=/path/to/config.toml pagerunner mcp

Environment Variables

  • PAGERUNNER_CONFIG_PATH — override config file location
  • PAGERUNNER_DB_PATH — override database location (default: ~/.pagerunner/state.db)
  • ANTHROPIC_API_KEY — required for generate_adapter (auto-generates site adapters)
  • RUST_LOG — set to debug for verbose logging

Variables in ~/.pagerunner/.env are auto-loaded.

Full Config Reference

config.toml
# ─── Profiles ───────────────────────────────
[[profiles]]
name = "work"
display_name = "Work Account"
# user_data_dir = "/custom/path" # optional
# debug_port = 9222 # optional, auto-assigned
# kind = "personal" # "personal" or "agent"
 
[[profiles]]
name = "research"
display_name = "Research"
 
# ─── Security ──────────────────────────────
[security]
sanitize_content = true # strip hidden elements and scripts
scan_injections = true # detect prompt injection patterns
# allowed_domains = ["github.com", "*.internal.co"] # empty = allow all
# max_navigations = 50 # limit page loads per session
# blocked_tools = ["evaluate"] # always forbidden
# allowed_tools = [] # empty = allow all
 
# ─── PII Anonymization ────────────────────
[[anonymization.profiles]]
name = "work-apps"
domains = ["jira.acme.com", "*.atlassian.net"]
mode = "tokenize" # "tokenize" (reversible) or "redact" (permanent)
entities = ["EMAIL", "PHONE", "CREDIT_CARD", "SSN", "PERSON"]
 
[[anonymization.profiles.custom_patterns]]
name = "TICKET"
pattern = "PROJ-\\d+"
 
# ─── Network ──────────────────────────────
[network]
buffer_capacity = 500 # network log buffer size
 
# ─── Checkpoints ──────────────────────────
[checkpoints]
enabled = true
interval_seconds = 300 # auto-checkpoint every 5 minutes
 
# ─── Retention ────────────────────────────
[retention]
max_snapshot_versions = 10 # per (profile, origin)
site_knowledge_ttl_days = 0 # 0 = keep forever
 
# ─── Recordings ───────────────────────────
[recording]
# storage_dir = "/custom/path" # default: ~/.pagerunner/recordings/
retention_days = 0 # 0 = keep forever
max_size_mb = 0 # 0 = unlimited
format = "mp4" # "mp4" or "webm"
auto_record = false
fps = 10 # capture frame rate (1-15)
output_fps = 30 # output frame rate
 
# ─── Recording Overlay ────────────────────
[overlay]
position = "bottom" # "top" or "bottom"
font = "Helvetica"
font_size = 36
text_color = "white"
bg_color = "#000000AA"
bar_height = 120
 
# ─── NER (optional, requires --features ner) ──
[ner]
enabled = true
 
# ─── Agent (for daemon autonomous agent) ──
[agent]
enabled = false

Anonymization Entity Types

  • Regex-based (always available): EMAIL, PHONE, CREDIT_CARD, IBAN, SSN, IP, SECRET
  • NER-based (requires --features ner): PERSON, ORG
  • SECRET scrubs 18+ token formats: npm, GitHub, Stripe, OpenAI, AWS, JWT, PEM keys, etc.

Next: Security →