Set up your twin.
Everything between downloading the app and your twin holding a phone call in your voice. Start at the top; the deeper pieces (voice, Gmail, how it remembers you) each stand alone.
- 01 · What Twinly is
Twinly is a clone of you that lives on your Mac or Windows PC: it texts, emails, manages your calendar, works your websites and apps, and holds real phone calls in your voice. You choose how much it asks first. The AI engine is included: start free with 5 tasks a day.
- 02 · Install & first launch
Download Twinly for Mac or Windows, open it, and let the first-launch setup sign you in and grant every permission on one screen. No terminal, no developer tools, about five minutes.
- 03 · Powering your twin
Sign in and run on Twinly's managed engine: start free with 5 tasks a day, and plans from $20 a month raise the daily and weekly limits. The Developer API uses the same plan. Older beta builds bring their own provider key.
- 04 · Permissions
Every macOS permission Twinly asks for and why, in plain English, with exact System Settings paths. Grant them all on one screen at first launch, or with Set everything up on the Access screen.
- 05 · Approvals and control
Choose how much Twinly asks before it acts: every time, only before anything leaves your Mac, or not at all (the default, with a 5-second preview of each text and email). What always waits, undo, picking up a stopped task, and how to stop it.
- 06 · Messages and @twinly
Text as you from Messages on a Mac, and text @twinly in any conversation, from your phone too, to get things done there: pictures, voice notes in your voice, a split bill, a group vote, a calendar invite. Who can use it and what it may say.
- 07 · Websites and apps
How Twinly works websites, in its own background browser or your signed-in Chrome, how it drives your other Mac apps on screen, how to watch it live, and what it will not do.
- 08 · Voice & calls
Clone your own voice on your Mac with Twinly Voice, set up Google Voice in Chrome and the free BlackHole driver once, and let your twin hold real phone calls as you.
- 09 · Email (Gmail)
Connect Gmail with a Google App Password (2-Step Verification required) so your twin can send, read, search, and stay aware of new mail. What it unlocks, how to set it up, and what stays private.
- 10 · Connectors
Sign in to apps like Notion, Linear, GitHub, Stripe or HubSpot once, and your twin uses their own tools directly instead of clicking around their websites. The 26 apps, how sign-in works, and what waits for your OK.
- 11 · Developer API
Your Twinly as an API: OpenAI-compatible chat, computer-use actions and image generation from Twinly's servers, plus iMessages, phone calls in your voice, voice notes and full tasks run by your own Mac. Keys, every endpoint, jobs, webhooks, bots, pricing, errors, and the OpenAPI spec.
- 12 · For AI agents
Machine-readable entry points for assistants and coding agents reading about Twinly: llms.txt, the full docs as one markdown file, every page as markdown, and the Developer API's OpenAPI spec, plus the rules an agent integrating Twinly should follow.
- 13 · How Twinly executes
Why Twinly is reliable and cheap to run: it tries fast, certain layers first (recipes, learned pathways, an app's own interfaces), checks that committing actions really happened, and only spends an AI run on the genuinely new.
- 14 · How Twinly remembers you
Twinly's permanent memory, learned pathways, anticipation, and failure memory, explained for a user: what it learns, that it never forgets, how you stay in control, and how to reset it.
- 15 · Privacy & security
What stays on your device, what leaves and why, the rules Twinly follows in every approval mode, and how to stop the twin instantly. The trust model in plain terms.
- 16 · Troubleshooting
Fixes for the common snags: a permission that needs re-toggling, a robotic voice, a website task that fails, a silent call, Gmail that won't connect, and @twinly that doesn't answer.