Claude Code & AI Agents

Use Notte with AI coding assistants like Claude Code, Cursor, and Windsurf

Install notte-cli

The Notte CLI lets AI agents control browsers through simple shell commands.

brew tap nottelabs/notte-cli https://github.com/nottelabs/notte-cli.git
brew install notte

Install notte-skill

Add the skill to your AI coding assistant for richer context:

npx skills add nottelabs/notte-cli

This works with Claude Code, Cursor, Windsurf, and other MCP-compatible assistants.

AGENTS.md / CLAUDE.md

For more consistent results, add to your project or global instructions file:

## Browser Automation

Use `notte` for web automation. Run `notte --help` for all commands.

Core workflow:
1. `notte sessions start` - Start a browser session
2. `notte page goto <url>` - Navigate to a URL
3. `notte page observe` - Get interactive elements with IDs (@B1, @B2)
4. `notte page click "@B1"` / `notte page fill "@I1" "text"` - Interact using element IDs
5. `notte page scrape --instructions "..."` - Extract structured data
6. `notte sessions stop` - Clean up when done

Tips

• Viewing headless sessions: When you start a session, the output includes a ViewerUrl - open it to watch your headless browser live
• Element selectors: If element IDs from observe (like @B1) don’t work, use Playwright selectors: #id, .class, button:has-text('Submit')
• Multiple matches: Use >> nth=0 suffix to select the first match: button:has-text('OK') >> nth=0
• Closing modals: notte page press "Escape" reliably dismisses most dialogs

Skills Documentation

For comprehensive documentation including templates and reference guides, see the skills/notte-browser folder and reference the notte-cli open source repo.