ManualTerminal, CLI, MCP
Terminal and agents.
Most of what the app does has a command, and an assistant can read, sort and draft your mail but never send it.
Setting up porch
- Install the command
- Settings → Command line → Install porch puts a small porch command on your PATH. Update and Remove are there too.
- The terminal UI
porch tuiis Porch in a terminal: the Gate, the boxes, reading, triage and drafts, on the same keys as the app. It uses your own access, so its drafts are yours.- Scripts
- Every command also takes
--json.
Commands
porch tui- The app in a terminal.
porch gate list · allow · block- The Gate. allow takes --to front, reader or ledger.
porch box front --new- A box’s threads; --limit, --offset or --all for more.
porch thread <id> · search <query>- Read a thread; search with the same syntax as the app.
porch queue · shelf · mute- add, rm or list.
porch resurface <id> --at "fri 9am"- Hide a thread until then.
porch archive · delete · unarchive · restore- Put a thread away, or bring it back.
porch rename · merge · split · stack- Organise threads, as in the app.
porch notify on <sender | thread>- Notifications; list shows what’s on.
porch files · boards · snippets- All Files, your boards, your snippets.
porch draft new · draft reply- Write a draft. Bodies are Markdown.
porch send <draft>- Asks you in the app; only Send there sends it.
porch doctor- Check every account’s connection.
Run porch with no arguments for the full list.
Agents
- A token for each
- Settings → Agents → New token. Give it read, draft or organise scope. It’s shown once; only a hash is kept.
- What no token can do
- Send, change settings or identities, trust images, or make other tokens.
- Connect over MCP
- Connect an agent, beside the new token, gives the exact
claude mcp addcommand, or themcpServersJSON for other apps, with the token filled in. - Their drafts
- Arrive in Drafts and Focus Reply, badged with the agent’s name, for you to edit and send.
- When an agent asks to send
porch sendopens a dialog in the app showing the draft. Only you pressing Send there sends it, and only that exact draft. The request expires after five minutes.