twinly. / Docs

Docs · 07

Websites and apps

On a website, Twinly does what you would: it reads the page, fills forms, picks dates and options, and clicks by the words on the buttons. In your other apps it works the screen. You can watch either one live.

01Two browsers, one way of working

Public sites run in Twinly's own browser, in the background, with nothing on your screen and your pointer left alone.

Your own accounts (“my cart”, “my orders”, your inbox, a school portal) run in your Chrome, signed in as you, through the optional Twinly Browser Control extension. The twin works in a background tab in its own Twinly tab group, so your tab, mouse and keyboard stay yours, and “add this to my cart” lands in your real cart. While it works, Chrome shows its “started debugging this browser” bar, which goes away when the task ends; pressing Cancel on that bar stops it.

Once a task starts in one browser, it stays there to the end.

02Forms and pages

  • Finds the box beside a label, fills fields by the hint written inside them, and reads each field back after filling it, so it never says it filled a field that stayed empty.
  • Picks dates straight from a calendar, and options from dropdowns, including ones that open below the edge of the screen.
  • Scrolls a button out from under cookie bars, sticky headers and fixed footers before clicking it, and scrolls the right panel when only part of a page moves.
  • Answers the page's own confirm pop-ups, and cancels one that would commit you unless that step was approved.

03Watching it work

Click the island while Twinly works on a website to watch the page live, with a ring where it last clicked. Pop it out into its own window any time; watching never interrupts the task. Finished website tasks keep a filmstrip of every step, so you can scrub back through what the twin saw.

04Your other apps

For apps that are not websites, the twin works the screen like you do: after every step it takes a screenshot, reads the window's controls and its text, and clicks and types with your real pointer and keyboard. Leave the Mac alone and the screen unlocked while it does. It reports what the window actually shows, not what it expected to see.

Where an app offers a better way in, Twinly uses it and skips the screen entirely: Calendar, Reminders and Contacts through the system, PDFs edited directly (combine, reorder, rotate, highlight, export), apps that can be scripted through their own scripting, and Connectors for apps like Notion or GitHub.

05What it will not do

  • Type a password, a card number, or an ID number like a Social Security number into any field. It fills in the rest and asks you to type that one value.
  • Solve a CAPTCHA or “I'm not a robot” check. For a site that shows one, it uses your own Chrome, where you are signed in, or hands the step to you.
  • Drive text-free graphics, like a 3D or CAD viewport, a drawing canvas, or a map with no labels, where there is nothing to read or target. It says so rather than guessing.