Lettuce on iPhone (preview)

A companion iOS app for your vault. Your notes live in iCloud and sync automatically across iPhone, iPad, and Mac — so the same vault is on every device with no manual export.

What you can do on the phone alone

Even with nothing else connected, the phone reads, edits, searches, and captures notes against your iCloud vault. Open a note, jot something down, search the whole vault — it syncs back to the Mac automatically.

The big feature: Mac-powered tools

Connect the phone to your Mac and you unlock tools that run on the Mac and report back to the phone:

• Chat across your whole vault (the phone is an MCP client of the Mac)

• Publish your site to GitHub

• Generate an on-demand briefing

• Export a note to DOCX, EPUB, PDF, or HTML

These all run on the Mac — the phone just asks for them and shows the results.

Capture from anywhere on the phone

Four ways into your vault that don’t start with opening a note:

• Voice capture — the mic button in the Capture sheet dictates straight into a note or task. Recognition runs entirely on-device (the app refuses to fall back to server transcription, and asks for Microphone + Speech permissions the first time). Notes land in your Inbox; tasks land in today’s note.

• Share sheet — share links, text, images, or PDFs from any app to Lettuce (several at once is fine), add an optional comment, and it’s saved into your vault’s Inbox/. Webpages arrive as a readable [title](url) link; images and files land in the vault’s attachments and are referenced from the note.

• Siri / Shortcuts — say “Add a note to Lettuce”, “Add a task to Lettuce” (with an optional due date), or “Open today in Lettuce”. Note and task capture happen in the background, without the app opening; all three are building blocks in the Shortcuts app.

• Widgets — Recent Notes (home screen and lock screen): tap a note to open that note, and the medium size has a one-tap quick-capture button. Open Tasks shows your open to-do count and next tasks, overdue first, straight from the Tasks rollup.

• Spotlight — notes appear in the system search screen; tapping a result opens it in Lettuce.

Everything captured this way is a plain .md file in the Inbox like any other note — triage it by hand, or let an inbox-processor automation title, tag, and file it overnight.

How to connect

You’ll link the two devices over Tailscale, a private network that securely connects your own devices. Nothing is exposed to the internet.

1. Install Tailscale on both devices

Get the free Tailscale app on both the iPhone and the Mac, and sign in to the same account on each. That’s what puts them on the same private network.

2. On the Mac: File ▸ Connect iPhone

Open File ▸ Connect iPhone. A guided panel runs a checklist:

1. Server running — Lettuce’s local server is up.

2. Shared on your Tailscale network — if it isn’t shared yet, click the one-click Share via Tailscale button.

3. Reachable — once the phone can reach it, the panel shows a QR code.

There’s also a “Keep running when Lettuce is closed” toggle. Turn it on and the connection keeps working even when you quit the Mac app — useful for overnight briefings and other scheduled work.

3. On the iPhone: Settings ▸ Mac Tools ▸ Scan to Connect

Go to Settings ▸ Mac Tools ▸ Scan to Connect and scan the QR code from the Mac. The URL and token fill in automatically — the secret transfers by scan and is never typed. The Mac then shows “✓ Your iPhone is connected”.

Is it secure?

Yes. The connection is secured by Tailscale (a private network between your own devices) plus a bearer token that gates the server. Nothing is public, and the token moves only by QR scan.

Troubleshooting

If the phone’s Mac Tools show offline, see Troubleshooting/06 Can’t reach your Mac.

Next steps

• Getting started/03 Your first agent connection - the same server, from a desktop agent

• Publishing/01 Publishing a note - what “Publish” does on the Mac