Terminal and agentsChapters
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 tui is 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 add command, or the mcpServers JSON 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 send opens 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.