---

name: atr-browser description: Control browser, automate browser interactions, navigate to URLs, click on webpages, fill forms, take screenshots, inspect webpages, web scraping with browser, test websites manually, or interact with web pages programmatically using ATR browser server mode. allowed-tools: Bash(atr browser:*)

ATR Browser Automation Skill

This skill provides browser automation capabilities through ATR's browser server mode. The browser server runs as a daemon process and accepts CLI commands for browser control.

Architecture

CopyClaude Code --> atr CLI (client) --> ATR Server + Browser

The browser runs in visible (non-headless) mode by default for debugging and verification.

Getting Started

Step 1: Check Browser Status and Start if Needed

Before any browser operations, verify the browser server is running:

Copyatr browser status

If the server is not running, start it:

Copyatr browser start

The server stores state at ~/.atr/browser.state which allows subsequent commands to discover the endpoint automatically.

Step 2: Navigate and Interact

Once running, use navigation and interaction commands to control the browser.

Command Categories

Lifecycle Commands

Navigation Commands

Page Management Commands

Interaction Commands

Inspection Commands

Screenshot Note: Use --file to save screenshots to /tmp/ with a timestamped filename (e.g., /tmp/atr-screenshot-20240105-103045.png). No need to specify a file path. Add --full for full-page screenshots. Without --file, returns base64-encoded image data.

Debugging Commands

Workflow Pattern

Follow this workflow for browser automation tasks:

1. Ensure Server Running

   Copyatr browser status || atr browser start
   

2. Navigate to Target

   Copyatr browser navigate https://example.com
   

3. Inspect Page Elements

   Copyatr browser snapshot
   

   This returns elements with unique IDs (UIDs) like e0, e1, etc.

4. Interact with Elements Target elements by:

   • Text content: "Sign In"
   • UID from snapshot: e5
   • CSS selector: .submit-button

5. Verify Results

   Copyatr browser url
   atr browser title
   atr browser screenshot --file
   

6. Cleanup When Done

   Copyatr browser stop
   

Using JSON Output

Add --json flag for structured output when parsing is needed:

Copyatr browser snapshot --json
atr browser list-pages --json
atr browser network --json

Element Targeting

The <target> parameter in click, fill, hover, and drag commands accepts:

1. Element UID: e0, e5 (from snapshot output)
2. Visible text: "Sign In", "Submit Form"
3. aria-label: Elements with matching aria-label attribute
4. data-testid: Elements with matching data-testid attribute
5. CSS selector: #login-button, .nav-link

Best practice: Use atr browser snapshot first to see available elements and their UIDs.

Keyboard Keys

For press-key command:

• Named keys: Enter, Tab, Escape, Backspace
• Modifiers: Control+a, Shift+Tab, Alt+Enter
• Arrow keys: ArrowUp, ArrowDown, ArrowLeft, ArrowRight

Troubleshooting

Browser won't start:

Copyatr browser status
rm ~/.atr/browser.state  # If stale state
atr browser start

Port already in use:

Copyatr browser start --port 9334

Element not found:

Copyatr browser snapshot --verbose --json

Additional Resources

For complete command reference with all flags, see references/commands-reference.md.