Skip to content
Tailapps

Try it

Press the buttons.

Six capabilities as real cards use them: the card’s JSON, what the approval sheet asks, and a live card to press. It all runs in your browser; nothing is sent anywhere.

Encrypted send

Mac · iPhone · CLI

Type on the Mac and press Ping. The value is sealed on the Mac, the relay only sees ciphertext, and the iPhone opens it and shows the alert.

"permissions": ["inbox:messages", "send:messages", "notify"],
"sources": {
  "messages": { "inbox": "messages", "on_receive": "received" }
},
"actions": {
  "ping": { "steps": [
    { "send": { "messages": { "text": "$draft" } },
      "alert": "$draft" }
  ] }
}

Trimmed from examples/ping.json

The approval sheet says this card wants to:

  • Receive events sent to its inbox messages
  • Send to its copies on your other devices
  • Show notifications

Ping · on your Mac

tailapps.com sees: —

iPhone · locked

PPing now

Opened on the phone. The relay never had the key.

Between devices and cards

Your cards talk to each other, sealed end to end.

One send step reaches your card on your other devices, or another card on this one. Values and files are encrypted on the sender and opened only on your paired devices.

Send to your devices

A send step delivers a value to the same card on every device you’re signed in on, or to one device by its id, so a phone card can reply to the Mac that asked.

Mac iPhone CLI

Card to card

Send to another card’s inbox, on the same device or another of yours. The receiving card opts in and names which cards may send to it.

Mac iPhone CLI

End-to-end encrypted

AES-256-GCM with keys that never reach our servers. Devices pair by QR code or a one-time code, and removing one rotates the key.

Mac iPhone CLI

Files up to 10 MB

Send a photo, a recording or a screenshot with the value. Each file gets its own key and is deleted once delivered, or after 24 hours.

Mac iPhone CLI

Alerts on the iPhone

Add an alert line and the iPhone shows a notification even with TailApps closed. It’s decrypted on the phone itself.

iPhone

Push URLs and webhooks

Any service can POST JSON to a card’s inbox through its push URL, with optional HMAC signing. These come from outside, so they’re HTTPS, not end-to-end.

Mac iPhone CLI

// In the app: send to the Mac, with an iPhone alert
{ "send": { "orders": "$order" }, "alert": "New order {$order.id}" }

// And receive it
"sources": { "orders": { "inbox": "orders", "on_receive": "add_order" } }
# From a server or CI job, as a paired device
tailapps send ping/messages '{"text":"Backup finished"}'
tailapps send quick-shot/incoming --file shot.png --alert "New shot"

# Run a command for every value that arrives
tailapps listen ping/messages -- ./on-ping.sh

How the encryption works: Security

Every capability

What runs where.

Straight from the catalogue the cards are checked against. The code is the step or source name your card uses, and the permission is what the person approves.

Between devices and apps

Send values and files to your other devices and to other apps, end-to-end encrypted.

  • send

    Send a value, with a file if you like, to this app on your other devices, or a value to another app. Optional iPhone alert, even with TailApps closed

    send:<inbox>

    Mac iPhone tailapps send

  • source: inbox

    Receive values from your other devices, other apps, hooks and webhooks (push URL)

    inbox:<name>

    Mac iPhone tailapps listen

  • source: devices

    List your signed-in devices, to pick where a send goes

    Mac iPhone

Web and APIs

Call any HTTPS API, with keys from the Keychain or a provider sign-in.

  • source: fetch

    Pull JSON from an API on a schedule, with a Keychain key (Mac) or an OAuth sign-in

    net:<host>

    Mac iPhone

  • fetch

    Make an HTTP request (GET, POST, PUT, PATCH, DELETE), including outgoing webhooks

    net:<host>

    Mac iPhone

  • open

    Open a web or mail link

    open:url

    Mac iPhone

Camera, sound and media

Photos, video clips, recordings and text, all from the user’s own tap.

  • camera.take

    Take a photo, or record a short video clip

    camera

    Mac iPhone

  • photos.pick

    Choose photos from the library, with no library permission

    iPhone

  • mic.record.start

    Start recording from the microphone

    mic.record

    Mac iPhone

  • mic.record.stop

    Stop and save the recording as an .m4a

    mic.record

    Mac iPhone

  • speech.transcribe

    Turn speech into text, on the device

    speech.transcribe

    Mac iPhone

  • vision.ocr

    Read text from an image, on the device

    vision.ocr

    Mac

  • share

    Open the share sheet (AirDrop, Messages, Mail…)

    share

    Mac iPhone

  • component: player

    Play a video or audio clip with the system’s controls

    Mac iPhone

Screen and desktop

Screenshots, screen recordings, displays, windows and the desktop picture.

  • screen.capture

    Take a screenshot of the screen, a window or an area

    screen.capture

    Mac

  • screen.record.start

    Record the screen, a window or an area, with sound

    screen.record

    Mac

  • screen.record.stop

    Stop the screen recording and get the MP4

    screen.record

    Mac

  • system: displays

    See the connected displays

    displays.read

    Mac

  • system: windows

    See which windows are open

    windows.read

    Mac

  • wallpaper.set

    Set the desktop picture, on every screen or one

    wallpaper.control

    Mac

Clipboard and files

Read and write the clipboard, take files in and save files out.

  • clipboard.read

    Read the clipboard on a tap: text, an image or files

    clipboard.read

    Mac iPhone

  • clipboard.write

    Copy text or an image

    clipboard.write

    Mac iPhone

  • source: clipboard

    Follow every copy

    clipboard.read

    Mac

  • component: drop

    A drop zone: drag files in, or click to choose

    Mac iPhone

  • files.pick

    Choose files with the system picker

    Mac iPhone

  • files.save

    Save into a folder you chose, or upload to your storage bucket

    files.write:<setting>

    Mac iPhone

Notifications and timers

Alerts now or at a set time, even when TailApps isn’t running.

  • notify

    Show a notification now, or at a set time like an alarm

    notify

    Mac iPhone

Commands and scripts

Run the tools you already use, never through a shell.

  • source: cli

    Run a command on a schedule and show its output

    cli:<binary>

    Mac

  • cli

    Run a command you approved

    cli:<binary> <first args…>

    Mac

  • source: script

    Run one of the app’s scripts on a schedule

    script:<name>

    Mac

  • script

    Run one of the app’s scripts, sandboxed

    script:<name>

    Mac

Mac system controls

Read and change sound, Wi-Fi, Bluetooth, power and more.

  • system: audio

    See the volume, mute, speakers and microphones

    audio.read

    Mac

  • audio.volume.set

    Set the volume

    audio.control

    Mac

  • audio.mute

    Mute or unmute the sound

    audio.control

    Mac

  • audio.input.mute

    Mute or unmute the microphone

    audio.control

    Mac

  • audio.output.set

    Switch speakers

    audio.control

    Mac

  • audio.input.set

    Switch microphones

    audio.control

    Mac

  • system: network

    See whether the Mac is online, and how

    network.read

    Mac

  • system: wifi

    See Wi-Fi status and the network’s name

    wifi.read

    Mac

  • wifi.power

    Turn Wi-Fi on or off

    wifi.control

    Mac

  • wifi.join

    Join a known Wi-Fi network

    wifi.control

    Mac

  • system: bluetooth

    See paired Bluetooth devices and their battery

    bluetooth.read

    Mac

  • bluetooth.connect

    Connect a paired Bluetooth device

    bluetooth.control

    Mac

  • bluetooth.disconnect

    Disconnect a paired Bluetooth device

    bluetooth.control

    Mac

  • system: power

    See battery and charging status

    power.read

    Mac

  • display.sleep

    Turn the display off

    power.control

    Mac

  • system: usage

    See processor, graphics, memory and disk use

    usage.read

    Mac

State and logic

The building blocks every action uses.

  • set

    Write state

    Mac iPhone

  • push

    Add to a list

    Mac iPhone

  • increment

    Count up or down

    Mac iPhone

  • remove

    Take items out of a list

    Mac iPhone

  • update

    Change items in a list

    Mac iPhone

  • refresh

    Run a source now

    Mac iPhone

  • if

    Branch on a value

    Mac iPhone

On an iPhone, a button whose action needs a Mac shows “Needs a Mac”, and the Mac can do the work and send the result back. Taking photos and clips, the photo and file pickers, reading the clipboard, sharing and starting a screen recording only run from the person’s own tap or click.

Building blocks

Native UI from plain JSON.

Cards are drawn by SwiftUI from the parts below, in light and dark, at every width. Values are formatted for the person’s locale when they’re shown.

Surfaces

  • TailApps’ menu: a card or a one-line row (Mac)
  • A status in the menu bar and the Dock, as a coloured pill (Mac)
  • A pop-out window, kept on top if you like (Mac)
  • The Dashboard, with every card on one board (Mac)
  • A card on the iPhone, with its own layout if it needs one
  • Keyboard shortcuts, global or in the card (Mac)

Components 31

avatar badge button calendar cell chart checklist code divider drop field gallery gauge heatmap icon image link list map menu message player progress qr section spacer stat steps table text timer

Laid out in rows, columns, grids and tiles, nested up to 4 levels.

Native form controls 12

text search textarea number stepper toggle slider select segmented date time color

One field part, bound to state. A change can run an action straight away, like the volume slider above.

Formatters 32

add ago bytes compact count currency date decode default delta duration encode flag hash hour hue lower map number offset percent pick seconds share time times tone truncate until upper url where

Piped in a binding, like $deploys.0.at | ago.

Keys and sign-ins

Call real APIs without handling secrets.

Your card names what it needs. The person signs in or pastes a key into TailApps, never into the card or a chat with an agent.

Connections

An API key goes in through a setup sheet and stays in the Keychain. TailApps adds it to fetch requests as a bearer token, basic auth, an API key header or query parameter. Anything echoed back is masked.

Mac

Sign in with a provider

OAuth with PKCE and no client secret, in the system’s own sign-in window. The token only goes to the hosts the card declares, over HTTPS, and refreshes on its own.

Mac · iPhone

Your CLI sign-ins

Scripts run sandboxed, away from your keys. With the person’s OK, a card can use the gh or git SSH sign-in you already have instead of asking for a new key.

Mac

For agents

Built for Claude Code and friends.

TailApps on the Mac is an MCP server. Agents read the catalogue, validate a card, install it behind the person’s approval, and drive it.

get_catalog get_guide validate_app create_app update_app list_apps get_app get_state set_state run_action show_ui export_app archive_app

validate_app tells the agent where each action runs (Mac, iPhone or both) and which surfaces the card still lacks. show_ui lets an agent ask the person a question in a native card.

Limits

  • App JSON 256 KB
  • Each script 32 KB
  • Fastest schedule every 5 seconds
  • Longest command or request 600 seconds
  • Layout nesting 4 levels
  • A file sent between devices 10 MB
  • A push to a push URL 64 KB, 10 a second

Coming soon

What’s next.

Planned, not built yet. We’ll move each one up the page when it ships.

Coming soon

Scan codes and get a location

QR and barcode scanning and a location fix on the iPhone, from a tap.

Coming soon

Widgets and Shortcuts

Home and Lock Screen widgets for any card, and running a card’s actions from Siri or the Action button.

Coming soon

Cards between people

Shared spaces, so a card can talk to other people’s devices, with a key per space.

Coming soon

Install from a link or QR code

Put a card on a device straight from a link, with no Mac needed for the iPhone.

Coming soon

Agents that use live cards

Agents read what a card shows and press its buttons, when the person turns it on.

Coming soon

Windows, Android and Linux

The same catalogue names on more devices. Until then, the CLI covers Linux and Windows.

Your cards, built by your agent.

Free during the beta. Start on your Mac, add your iPhone, and script it all from the terminal.

  • Mac
  • iPhone Beta
  • CLI
  • Windows Soon
  • Linux Soon
  • Android Soon

Then connect your agent:

claude mcp add tailapps -- /Applications/TailApps.app/Contents/MacOS/tailapps-mcp