Skip to content

Tips & Tricks

Get more out of Mole with these tips.

Your Browser, Your Workspace

Mole is not a remote scraper or a simulated browser — it runs directly inside the Chrome you're already using.

This means login session reuse. Any website you're signed into — e-commerce, GitHub, Slack, internal admin panels — Mole can operate on directly. The website sees your real session, no extra authentication triggered.

Where This Shines

  • Managing orders on e-commerce sites you're already logged into
  • Working with internal company tools and admin panels
  • Organizing information on social media platforms
  • Accessing member-only content
  • Operating on banking and finance sites (sensitive actions always ask for your confirmation)

Your Data Stays Safe

  • All operations happen locally in your browser
  • Your cookies and login credentials are never sent to any external service
  • Irreversible actions (form submission, payment, deletion) always ask for your confirmation first

The Floating Ball

Mole places a small floating ball on every webpage — your entry point to the AI assistant.

  • Keyboard shortcutCmd+M (Mac) / Ctrl+M (Windows) to quickly open the search box
  • Drag to move — Drag the floating ball anywhere on screen; your preferred position is remembered
  • Stays out of the way — It hugs the screen edge and hides itself; hover to reveal
  • Real-time updates — As Mole works, you see status updates streaming in real time

Workflow Recorder

Don't want to repeat the same steps every day? Record them once, and Mole replays them for you.

How It Works

  1. Start Recording — Click the "Record Workflow" button at the bottom of the search box
  2. Do your thing — Perform the task as you normally would. Mole watches silently in the background
  3. Mark the result — After stopping, click on the element that represents the result (optional)
  4. Mole cleans it up — The AI removes accidental clicks, merges keystrokes, and identifies parts that should be customizable (like search terms)
  5. Use it anytime — The workflow is saved and ready. Next time, just ask "run my check-in workflow" or similar

Recording continues even if the page navigates — Mole tracks the whole flow.

Screenshots and Visual Understanding

Mole can take screenshots and actually understand what's on screen. This is useful when:

  • The page has charts, images, or Canvas content that can't be read as text
  • You need to verify how something looks (layout, colors, positioning)
  • There are many similar elements on the page and you need Mole to identify the right one visually

In annotated mode, Mole marks every clickable element with a number, making it easy to say "click element 3" with precision.

Task Recovery

If something goes wrong mid-task — a network hiccup, the browser restarting, or an API timeout — Mole doesn't lose your progress.

You'll see a Retry button. Click it, and Mole picks up right where it left off, with full memory of what it already did. No need to start over.

Safety Checks

Mole has built-in safety for sensitive actions:

  • Confirmation before action — Before submitting a form, making a payment, or deleting anything, Mole pauses and asks "Are you sure?"
  • Questions when unsure — If Mole encounters multiple options or needs information it doesn't have, it asks you directly with clear choices

You're always in control.

Session History

Every conversation with Mole is saved. Open the Options page to browse past sessions, review what happened, and pick up where you left off.

Pro Tips

  • Be specific — "Search Amazon for wireless keyboards under $50" beats "find me a keyboard"
  • Reference what you see — Mole can see your page. "Click the blue button" or "extract the table below" just works
  • Chain requests — Ask follow-up questions in the same conversation for context-aware responses
  • Use workflows for repetition — If you do something more than twice, record it as a workflow
  • Multiple tabs — Mole can work across tabs. "Open Amazon, search for X, then come back here and fill in the price" is a valid request

Released under the AGPL-3.0 License