Skip to content

docs: add troubleshooting tips and selector syntax guide#45

Merged
giordano-lucas merged 1 commit intomainfrom
docs/improve-troubleshooting-tips
Feb 4, 2026
Merged

docs: add troubleshooting tips and selector syntax guide#45
giordano-lucas merged 1 commit intomainfrom
docs/improve-troubleshooting-tips

Conversation

@giordano-lucas
Copy link
Member

@giordano-lucas giordano-lucas commented Feb 4, 2026

  • Add Tips & Troubleshooting section to SKILL.md covering observe workarounds, Playwright selectors, nth syntax, and modal handling
  • Document ViewerUrl for watching headless sessions live
  • Add bot detection / stealth troubleshooting guide
  • Add Tips subsection to README.md for quick reference
  • Enhance form-automation.sh template with selector examples

Based on user feedback about observe inconsistency and selector confusion.

Greptile Overview

Greptile Summary

This PR expands the documentation around browser automation ergonomics: it adds a quick “Tips” section to the main README and a more detailed “Tips & Troubleshooting” section to the notte-browser skill guide. The new docs focus on practical workarounds for occasional observe inconsistencies, using Playwright selector syntax (including >> nth=), handling modals, and viewing headless sessions via the viewer URL / notte sessions viewer. The form automation template is also updated with selector examples in comments for easier copy/paste.

Confidence Score: 4/5

  • This PR is safe to merge with minimal risk since it only updates documentation and templates.
  • Changes are documentation-only; the main risk is user confusion from inconsistent selector/ID syntax examples rather than runtime breakage.
  • README.md and skills/notte-browser/SKILL.md (ensure selector/ID syntax matches actual CLI behavior).

Important Files Changed

Filename Overview
README.md Adds a short Tips section about viewer URL, Playwright selectors, nth syntax, and closing modals; minor inconsistency with existing selector/id examples.
skills/notte-browser/SKILL.md Adds a substantial Tips & Troubleshooting section (observe inconsistency, selector syntax, modals, viewer, bot detection); appears accurate but duplicates/varies ID/selector conventions in places.
skills/notte-browser/templates/form-automation.sh Expands comments in the form automation template with selector examples; no functional code changes.

Copy link

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

3 files reviewed, 1 comment

Edit Code Review Agent Settings | Greptile

- Add Tips & Troubleshooting section to SKILL.md covering observe
  workarounds, Playwright selectors, nth syntax, and modal handling
- Document ViewerUrl for watching headless sessions live
- Add bot detection / stealth troubleshooting guide
- Add Tips subsection to README.md for quick reference
- Enhance form-automation.sh template with selector examples
- Fix element ID syntax consistency (use @b1 format everywhere)

Based on user feedback about observe inconsistency and selector confusion.
@giordano-lucas giordano-lucas force-pushed the docs/improve-troubleshooting-tips branch from 626b132 to 0057771 Compare February 4, 2026 15:20
@giordano-lucas giordano-lucas merged commit fe84291 into main Feb 4, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant