> ## Documentation Index
> Fetch the complete documentation index at: https://pipit.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Draft

> Ask Pipit to write something for you from what's on your screen.

Draft **Writes it for you, from your screen**. Instead of typing what you say, Pipit writes what you ask for. Say "reply that Friday works" in a chat, and Draft writes the reply, using the conversation on your screen so it fits.

## What Draft needs

* **AI cleanup, set up and on.** Draft uses the AI provider you chose under **Enhance** > **Runs on**. See [AI cleanup](https://pipit.mintlify.site/ai-cleanup.md).
* **Screen reading.** On the **Dictionary** tab, under **Settings**, turn on **Read names on screen** and then **Use on-device OCR**.
* **Screen Recording permission.** Pipit asks for it when you turn on **Use on-device OCR**. See [Permissions](https://pipit.mintlify.site/permissions.md).

If screen access is missing after you set a Draft key, **Home** shows "Draft is waiting for screen access". Click its button (**Turn on screen reading** or **Allow Screen Recording**) to fix it in one step.

## Set a Draft key

Draft has its own key, and it has none until you set one.

**1. Open Shortcuts**

In Pipit, go to **Home** > **Shortcuts**. If you see **Enhance and Draft** with **Set up AI**, set up [AI cleanup](https://pipit.mintlify.site/ai-cleanup.md) first.

**2. Pick the Draft row**

Next to **Draft**, click **Set shortcut**.

**3. Press a key**

Press the key you want, such as **Right Option**. It can't be the same as your **Dictate** key.

Setting a Draft key also changes your **Dictate** key: it now pastes your words without AI cleanup. See [Shortcuts](https://pipit.mintlify.site/shortcuts.md).

## Write something

1. Click where the text should go, like a reply box.
2. Hold your Draft key and say what you want written, for example "reply that Friday works".
3. Let go. Pipit writes it and pastes it in.

While you hold the key, a pencil shows next to the recording dot.

### Rewrite selected text

Select some text first, then hold your Draft key and say what to change, like "make this friendlier". Draft replaces the selection with the new version.

## Revise, undo, or copy

After a Draft lands, a strip appears with these options:

| Option | What it does |
| - | - |
| **Revise** | Click it, and it changes to **Hold to revise**. Hold your Draft key and say what to change, like "shorter". Pipit swaps in the new version. |
| **Undo** | Takes the Draft back out of the text field, and puts back any text it replaced. |
| **Copy** | Copies the Draft to your clipboard. |
| Versions | After a revision, use the arrows to step between versions. The one you pick goes into the text field. |

In some apps Pipit can't edit the text in place, so the strip offers only **Copy**.

## If Draft doesn't work

| Message | Fix |
| - | - |
| Draft needs an AI provider. | Click **Set up** and finish [AI cleanup](https://pipit.mintlify.site/ai-cleanup.md) setup. |
| Draft reads your screen for context. Turn on screen reading to use it. | Click **Turn on**, and allow Screen Recording if macOS asks. |
| Draft didn't come back, so nothing was pasted. | Click **Try again**. What you said is saved in [History](https://pipit.mintlify.site/history.md). |
| Draft skipped: the selection contains a key. | Nothing was sent. Deselect the key or password and try again. |

If the AI provider itself fails, you'll see the same messages as for AI cleanup. See [AI cleanup](https://pipit.mintlify.site/ai-cleanup.md#when-cleanup-fails).

## Privacy

When you use Draft, Pipit sends text to the AI provider you chose: what you asked for, text from the window you're writing in (like the message you're replying to), and any text you selected. Your audio stays on your Mac. Pipit doesn't read password or sign-in screens. See [Privacy](https://pipit.mintlify.site/privacy.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.