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
On Linux and Windows the porch command comes with the app. On a Mac, Install porch in Settings → Agents or Settings → Command line 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 sync
Check for mail now. Yours only: agents can’t ask.
porch doctor
Check every account’s connection.
porch skill install
The guide for agents, where they find it. porch skill help lists the rest.

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.
The guide they read
A skill that tells an agent what the Gate and each box mean, and the rules: it never sends, and Gate decisions are yours. Install skill in Connect an agent puts it where Claude Code finds it (~/.claude/skills), and the Command line tab does the same for Codex and others (~/.agents/skills). For Claude Desktop and claude.ai, Save skill as .zip and upload it in Customize → Skills. The app keeps an installed skill up to date. From a terminal: porch skill install.
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.