kyleamathews/linux-config/surf-cli

# Navigate to a URL
npx surf go "https://example.com"
 
# Back/forward navigation
npx surf back
npx surf forward
 
# Reload the page
npx surf tab.reload

# Get accessibility tree + visible text (best for understanding page structure)
npx surf read
 
# Get just the text content
npx surf page.text
 
# Get page state (URL, title, etc.)
npx surf page.state

# Take a screenshot (auto-resized to 1200px for token efficiency)
npx surf screenshot
 
# Full resolution screenshot
npx surf screenshot --full
 
# Screenshot with element annotations
npx surf snap

# Click an element (use CSS selector or text)
npx surf click "button.submit"
npx surf click "Sign In"
 
# Type text into focused element
npx surf type "hello world"
 
# Type into specific element
npx surf type "hello world" --selector "input[name=email]"
 
# Press keyboard keys
npx surf key "Enter"
npx surf key "Tab"
npx surf key "Escape"
 
# Scroll
npx surf scroll down
npx surf scroll up
npx surf scroll "selector"  # Scroll element into view

# List all tabs
npx surf tab.list
 
# Open new tab
npx surf tab.new "https://example.com"
 
# Switch to tab by index or name
npx surf tab.switch 2
npx surf tab.switch "Gmail"
 
# Close current tab
npx surf tab.close
 
# Name current tab (for easier switching)
npx surf tab.name "My Tab"

# Send prompt to ChatGPT
npx surf chatgpt "Explain quantum computing"
 
# Send prompt to Gemini
npx surf gemini "Write a haiku about coding"
 
# Send prompt to Perplexity
npx surf perplexity "Latest news on AI"

# Navigate to form
npx surf go "https://example.com/login"
 
# Fill fields
npx surf click "input[name=email]"
npx surf type "user@example.com"
npx surf key "Tab"
npx surf type "password123"
 
# Submit
npx surf click "button[type=submit]"
 
# Verify result
npx surf screenshot

# Navigate and wait for content
npx surf go "https://example.com/article"
 
# Get page content
npx surf read
 
# Take screenshot for visual verification
npx surf screenshot

# Open multiple research tabs
npx surf tab.new "https://docs.example.com"
npx surf tab.name "Docs"
npx surf tab.new "https://github.com/repo"
npx surf tab.name "GitHub"
 
# Switch between them
npx surf tab.switch "Docs"
npx surf read
npx surf tab.switch "GitHub"
npx surf read

# Check connection status
npx surf
 
# If no connection, ensure:
# 1. Chrome is running
# 2. Surf extension is installed and enabled
# 3. Extension has connected (check extension popup)