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
For developers
Every capability TailApps gives your cards, on each device. Your card is one JSON file: declare what it needs, and the person approves it once.
The most complete set: commands and scripts, screen recording, system controls, files, APIs and messaging. Agents build cards here over MCP.
The same cards, on your phone. Camera, photos, microphone, clipboard, notifications, APIs and messaging, all compiled in.
The tailapps command is a device of its own on macOS, Linux and Windows: send to and listen on any card’s inbox, end-to-end encrypted.
Try it
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.
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:
Ping · on your Mac
iPhone · locked
PPing now
Opened on the phone. The relay never had the key.
Tap Snap on your iPhone. The photo is taken in the system camera, uploaded straight to the storage bucket you chose, and the link is ready to copy.
"permissions": ["camera", "files.write:dest", "clipboard.write"],
"actions": {
"snap": { "steps": [
{ "camera.take": {}, "as": "photo" },
{ "files.save": { "data": "$photo.path", "to": "$settings.dest",
"name": "photo-{$now}.jpg" }, "as": "saved" },
{ "clipboard.write": { "text": "$saved.url" } }
] }
}
Trimmed from examples/photo-drop.json
The approval sheet says this card wants to:
Photo Drop
Photos go to your bucket.
Pick a length and press Start. The notification is booked for the end time, so it rings even if TailApps isn’t running.
"permissions": ["notify"],
"actions": {
"start": { "steps": [
{ "set": { "ends_at": "$now", "status": "running" } },
{ "increment": { "ends_at": "$length" } },
{ "notify": { "title": "Tea", "body": "Time's up",
"at": "$ends_at", "id": "timer" } }
] },
"pause": { "steps": [ { "notify": { "cancel": "timer" } } ] }
}
Trimmed from examples/timer.json
The approval sheet says this card wants to:
Tea
0:05
TailApps · now
Tea
Time’s up
Drag the slider or press Mute. The card reads the Mac’s sound live, and each change returns what it was before, so Undo is one step.
"permissions": ["audio.read", "audio.control"],
"sources": { "sound": { "system": "audio" } },
"actions": {
"set_volume": { "steps": [ { "audio.volume.set": "$args.value" } ] },
"mute": { "steps": [ { "audio.mute": "toggle" } ] }
},
"cards": [{ "id": "main", "layout": { "column": [
{ "field": "Volume", "type": "slider", "min": 0, "max": 100,
"value": "$sound.volume", "on_change": "set_volume" },
{ "button": "Mute", "on": "mute" }
] } }]
Trimmed from examples/system-controls.json
The approval sheet says this card wants to:
Sound
{ "system": "audio" } → volume 62
Press Record. A red item shows in the menu bar while it records; Stop gives you an MP4 to share or upload.
"permissions": ["screen.record", "mic.record", "share"],
"actions": {
"record": { "steps": [
{ "screen.record.start": { "target": "pick", "sound": true } }
] },
"stop": { "steps": [
{ "screen.record.stop": {}, "as": "rec" },
{ "set": { "clip": "$rec.path", "seconds": "$rec.seconds" } }
] },
"share_clip": { "steps": [ { "share": { "file": "$clip" } } ] }
}
Trimmed from examples/recorder.json
The approval sheet says this card wants to:
Recorder
Press Sign in. The system’s own sign-in sheet opens, and the token only ever goes to api.linear.app. No API key to paste.
"permissions": ["net:api.linear.app"],
"oauth": {
"linear": { "name": "Linear",
"authorize": "https://linear.app/oauth/authorize",
"token": "https://api.linear.app/oauth/token",
"client_id": "…", "scope": "read",
"hosts": ["api.linear.app"] }
},
"sources": {
"issues": { "fetch": "https://api.linear.app/graphql",
"method": "POST", "auth": "oauth:linear",
"select": "data.viewer.assignedIssues.nodes", "every": 300 }
}
Trimmed from examples/linear.json
The approval sheet says this card wants to:
Linear
Sign in with Linear to use this card
linear.app
TailApps wants to read your issues.
My issues
Sample issues. Nothing here talks to Linear.
Between devices and cards
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.
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
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
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
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
Add an alert line and the iPhone shows a notification even with TailApps closed. It’s decrypted on the phone itself.
iPhone
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
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.
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
Runs on Mac Runs on iPhonetailapps send
source: inbox
Receive values from your other devices, other apps, hooks and webhooks (push URL)
inbox:<name>
Mac iPhone tailapps listen
Runs on Mac Runs on iPhonetailapps listen
source: devices
List your signed-in devices, to pick where a send goes
Mac iPhone
Runs on Mac Runs on iPhone Not on CLICall 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
Runs on Mac Runs on iPhone Not on CLIfetch
Make an HTTP request (GET, POST, PUT, PATCH, DELETE), including outgoing webhooks
net:<host>
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIopen
Open a web or mail link
open:url
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIPhotos, 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
Runs on Mac Runs on iPhone Not on CLIphotos.pick
Choose photos from the library, with no library permission
iPhone
Not on Mac Runs on iPhone Not on CLImic.record.start
Start recording from the microphone
mic.record
Mac iPhone
Runs on Mac Runs on iPhone Not on CLImic.record.stop
Stop and save the recording as an .m4a
mic.record
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIspeech.transcribe
Turn speech into text, on the device
speech.transcribe
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIvision.ocr
Read text from an image, on the device
vision.ocr
Mac
Runs on Mac Not on iPhone Not on CLIshare
Open the share sheet (AirDrop, Messages, Mail…)
share
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIcomponent: player
Play a video or audio clip with the system’s controls
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIScreenshots, screen recordings, displays, windows and the desktop picture.
screen.capture
Take a screenshot of the screen, a window or an area
screen.capture
Mac
Runs on Mac Not on iPhone Not on CLIscreen.record.start
Record the screen, a window or an area, with sound
screen.record
Mac
Runs on Mac Not on iPhone Not on CLIscreen.record.stop
Stop the screen recording and get the MP4
screen.record
Mac
Runs on Mac Not on iPhone Not on CLIsystem: displays
See the connected displays
displays.read
Mac
Runs on Mac Not on iPhone Not on CLIsystem: windows
See which windows are open
windows.read
Mac
Runs on Mac Not on iPhone Not on CLIwallpaper.set
Set the desktop picture, on every screen or one
wallpaper.control
Mac
Runs on Mac Not on iPhone Not on CLIRead 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
Runs on Mac Runs on iPhone Not on CLIclipboard.write
Copy text or an image
clipboard.write
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIsource: clipboard
Follow every copy
clipboard.read
Mac
Runs on Mac Not on iPhone Not on CLIcomponent: drop
A drop zone: drag files in, or click to choose
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIfiles.pick
Choose files with the system picker
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIfiles.save
Save into a folder you chose, or upload to your storage bucket
files.write:<setting>
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIAlerts 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
Runs on Mac Runs on iPhone Not on CLIRun the tools you already use, never through a shell.
source: cli
Run a command on a schedule and show its output
cli:<binary>
Mac
Runs on Mac Not on iPhone Not on CLIcli
Run a command you approved
cli:<binary> <first args…>
Mac
Runs on Mac Not on iPhone Not on CLIsource: script
Run one of the app’s scripts on a schedule
script:<name>
Mac
Runs on Mac Not on iPhone Not on CLIscript
Run one of the app’s scripts, sandboxed
script:<name>
Mac
Runs on Mac Not on iPhone Not on CLIRead and change sound, Wi-Fi, Bluetooth, power and more.
system: audio
See the volume, mute, speakers and microphones
audio.read
Mac
Runs on Mac Not on iPhone Not on CLIaudio.volume.set
Set the volume
audio.control
Mac
Runs on Mac Not on iPhone Not on CLIaudio.mute
Mute or unmute the sound
audio.control
Mac
Runs on Mac Not on iPhone Not on CLIaudio.input.mute
Mute or unmute the microphone
audio.control
Mac
Runs on Mac Not on iPhone Not on CLIaudio.output.set
Switch speakers
audio.control
Mac
Runs on Mac Not on iPhone Not on CLIaudio.input.set
Switch microphones
audio.control
Mac
Runs on Mac Not on iPhone Not on CLIsystem: network
See whether the Mac is online, and how
network.read
Mac
Runs on Mac Not on iPhone Not on CLIsystem: wifi
See Wi-Fi status and the network’s name
wifi.read
Mac
Runs on Mac Not on iPhone Not on CLIwifi.power
Turn Wi-Fi on or off
wifi.control
Mac
Runs on Mac Not on iPhone Not on CLIwifi.join
Join a known Wi-Fi network
wifi.control
Mac
Runs on Mac Not on iPhone Not on CLIsystem: bluetooth
See paired Bluetooth devices and their battery
bluetooth.read
Mac
Runs on Mac Not on iPhone Not on CLIbluetooth.connect
Connect a paired Bluetooth device
bluetooth.control
Mac
Runs on Mac Not on iPhone Not on CLIbluetooth.disconnect
Disconnect a paired Bluetooth device
bluetooth.control
Mac
Runs on Mac Not on iPhone Not on CLIsystem: power
See battery and charging status
power.read
Mac
Runs on Mac Not on iPhone Not on CLIdisplay.sleep
Turn the display off
power.control
Mac
Runs on Mac Not on iPhone Not on CLIsystem: usage
See processor, graphics, memory and disk use
usage.read
Mac
Runs on Mac Not on iPhone Not on CLIThe building blocks every action uses.
set
Write state
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIpush
Add to a list
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIincrement
Count up or down
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIremove
Take items out of a list
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIupdate
Change items in a list
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIrefresh
Run a source now
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIif
Branch on a value
Mac iPhone
Runs on Mac Runs on iPhone Not on CLIOn 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
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.
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.
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.
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
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.
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
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
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
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.
Coming soon
Planned, not built yet. We’ll move each one up the page when it ships.
QR and barcode scanning and a location fix on the iPhone, from a tap.
Home and Lock Screen widgets for any card, and running a card’s actions from Siri or the Action button.
Shared spaces, so a card can talk to other people’s devices, with a key per space.
Put a card on a device straight from a link, with no Mac needed for the iPhone.
Agents read what a card shows and press its buttons, when the person turns it on.
The same catalogue names on more devices. Until then, the CLI covers Linux and Windows.
Free during the beta. Start on your Mac, add your iPhone, and script it all from the terminal.
Then connect your agent:
claude mcp add tailapps -- /Applications/TailApps.app/Contents/MacOS/tailapps-mcp