why we built it

We dictate to Miládka from the car and she writes to us herself when something is going on. All it takes is WhatsApp. A few sentences into the phone between meetings, and by the time we arrive it is in our tasks, in our notes or ready as a draft email. And when an urgent email comes in, she gets in touch on WhatsApp herself. Miládka transcribes voice notes with her own model right on the computer: your voice goes nowhere and the transcription costs nothing.

The Claude app can't do this by itself. WhatsApp can't be connected to it and it can't transcribe a voice note from it. We didn't find a ready-made solution we would trust, so we built our own. You get exactly what we use ourselves every day. The guide is written mainly for Miládka: what she can do herself, she does, and she asks you about everything that depends on your preferences.

Karel Derfl

What it does

  • You dictate, Miládka acts. You say a few sentences into the phone and Miládka turns them into a task, a note or a draft email. The transcription runs right on your computer.
  • She gets in touch herself. When an urgent email comes in, she writes to you on WhatsApp, even when you are not sitting at the computer. All you need is your mail connected.
  • You write to her like to anyone else. A task, a meeting, a question about anything she knows about your work. She replies on WhatsApp, usually within half a minute.
  • An overview of your messages. Who wrote what shows up in your morning brief, together with your mail.
  • Instructions only from you. Messages from anyone else are just information for Miládka, whatever they say.

What it looks like

You are driving back from a meeting and say into the phone: "Note that we send Novák the offer by Friday, and draft him an email that we are working on it." Miládka transcribes the voice note, adds the task with its deadline, prepares a draft email and writes to you on WhatsApp what she did. The email goes out only when you approve it.

Two ways to use it

Miládka links to the WhatsApp account that scans the QR code. Depending on which one, she can do two different things:

  • Miládka has her own number (recommended). A second SIM, an eSIM or an old phone is enough. You write to her from your phone like to anyone else, and she replies.
  • Miládka on your number, much like with email. She reads your chats, drafts replies and sends on your behalf only what you approve. You can't give her instructions over WhatsApp: to her, your messages are sent by you.

The risk to your number. Miládka connects to WhatsApp as another linked device, just like WhatsApp Web, but in an unofficial way. WhatsApp's terms forbid it and WhatsApp can ban the number for it. That's why we recommend a separate number for Miládka, not your main one.

What to expect

Miládka does the setup. From you she only needs what she can't do for you:

  • Decide which number. Miládka's own number, or yours.
  • Allow the connection. One confirmation when the Claude app asks.
  • Scan a QR code. With the phone that has the WhatsApp account for Miládka.
  • Turn on voice note transcription. Recommended. A one-time download of about 510 MB.

Step 1 - Write to Miládka

Copy this into the chat with Miládka:

Message for Miladka

Connect WhatsApp for me following the guide https://miladka.cz/navod/whatsapp

Miládka reads the guide and takes you through it one step at a time. First she explains the risk and asks which number you want to use. Then she suggests settings (which chats she may read, whom she may write to, how long to keep photos) and asks whether you want anything different.

Step 2 - Allow the connection

Miládka asks you to open a new conversation. The Claude app asks there whether to allow the whatsapp server. Allow it and write to Miládka "Continue connecting WhatsApp".

Step 3 - Scan the QR code

Get the phone with WhatsApp for Miládka ready: Settings → Linked devices → Link a device. Once you say the camera is ready, Miládka opens an image with the QR code.

Windows

It opens in the Photos app.

Mac

It opens in Preview.

Scan the code with the phone. It's valid only for a short while. If you miss it, tell Miládka and she shows a new one.

Step 4 - Turn on voice note transcription

Miládka offers to transcribe voice notes. We recommend turning it on, it is what lets you dictate to her. The transcription model downloads once, about 510 MB, and then Miládka transcribes every voice note right on your computer, without sending it to another service and without a fee. If you don't want it, voice notes keep coming as audio files.

How it works afterwards

  • Miládka replies while the Claude app is running with her conversation. She reacts to a message within half a minute. When the computer is off or the app is closed, messages wait and Miládka goes through them once you open it.
  • Waiting costs nothing. A small program on your computer watches for new messages, not Miládka. It wakes her only when you write. Each wake-up then uses a bit of your Claude subscription limit, much like a question in the chat.
  • The transcription is done by a machine. Names, numbers and dates that something depends on, Miládka checks before she acts on them.
  • Other people can wake her too. If you want messages from a colleague or a project group right away, tell Miládka. She still takes instructions only from you.
  • Photos and voice notes are saved to the inbox/whatsapp folder and deleted after 30 days. Message text and transcripts stay. Whatever you want to keep for good, she moves to your sources.

Security

  • Only on your computer. The link and the stored messages stay in Miládka's folder on your computer. They don't go into the GitHub backup.
  • Firm limits. You decide which chats she may read and whom she may write to. She doesn't change that on her own.
  • Disconnect any time. On the phone under Linked devices, or just tell Miládka.

When it doesn't work

Miládka doesn't answer messages from the phone
The Claude app has to be running with Miládka's conversation open. Open it and ask her to check WhatsApp.
The linked device disappeared from the phone
WhatsApp sometimes unlinks it on its own. Ask Miládka to pair WhatsApp again and scan the new QR code.
Anything else
tell Miládka what you see and she'll sort it out. If even she doesn't know what to do, she'll draft an email to podpora@miladka.cz for you.