All news

Porch from the keyboard, the terminal and your agents

Every action in Porch Mail has a key, most have a terminal command, and an AI assistant can read, sort and draft your mail. Only you can press Send.

How-to2 min read

Porch is built to be driven from the keyboard. If your hands never leave it, you can clear a day's mail without touching the mouse.

The keys worth learning first

  • Ctrl K opens the command palette. Every action is in it, with its key beside it.
  • 1 to 5 jump to the Gate, Front, Reader, Ledger and the Shelf.
  • Y marks a thread Done, # deletes it, R replies, C writes a new email.
  • Q adds a thread to the Reply Queue, S puts it on the Shelf, H brings it back tomorrow at nine.
  • ? shows every shortcut, and Ctrl Z undoes any of them.

The full list is in the shortcuts chapter.

In a terminal

Settings → Command line → Install porch puts a porch command on your path. porch tui is the app in a terminal, and most of what the app does has a command:

porch gate list
porch gate allow news@example.com --to reader
porch search "from:alex has:attachment"

For your agents

An AI assistant can work in your mailbox through MCP. Make a token in Settings → Agents → New token and give it read, draft or organise scope. Connect an agent then gives you the exact command to add it to Claude Code, or the JSON for other apps.

An agent can read, sort and draft. It can't send, change your settings or make other tokens. Its drafts land in Drafts and Focus Reply with its name on them, and they go out only when you press Send in the app. See Terminal and agents for every command and scope.