postie

Send files and text to your own devices (phone, tablet, laptop, browser) from any terminal, or from your AI coding agent. It's end-to-end encrypted, and goes over your Wi-Fi when the device is nearby.

Install

1. Install uv (it puts postie on your PATH for you). Search "install uv" and paste the command astral.sh shows:

   Platform	Command
   Windows (PowerShell)	winget install astral-sh.uv
   Mac / Linux	curl -LsSf https://astral.sh/uv/install.sh | sh

2. In a new terminal:

   uv tool install postie-cli
   uv tool update-shell
   

3. In another new terminal, postie login. Update later with uv tool upgrade postie-cli.

pip install postie-cli works too, but pip usually puts postie in a folder that isn't on your PATH (it prints a warning naming that folder). Add it to PATH yourself (on Windows: Start → "Edit environment variables for your account" → Path → New), or use uv.

Use

postie login                  # sign in with Google (or: postie login CODE)
postie photo.png m6           # device = any part of its name
postie photo.png m6,mac       # several at once, or: all
postie ./dist m6              # a folder is zipped
postie "hello" m6             # text
cmd | postie m6               # stdin
postie get                    # receive
postie ls                     # devices

The verb is optional, and the device you used last is the default. --json gives plain output for scripts.

For AI agents

postie mcp is an MCP server, so your coding agent can send to your devices. Add it once:

claude mcp add -s user postie -- postie mcp     # Claude Code
codex mcp add postie -- postie mcp              # Codex

Cursor (the app and its agent CLI) reads ~/.cursor/mcp.json. Add this to it:

{ "mcpServers": { "postie": { "command": "postie", "args": ["mcp"] } } }

Any other MCP agent: the command is postie, the argument is mcp. If an app can't find postie, give it the full path (which postie, or where postie on Windows).

Then ask your agent to "send the APK to my phone".

Get the Postie apps for Android, iPhone, Mac, Windows, Linux and the browser at postie.xlonlabs.com.