Integrations
Postal stores tasks as plain Markdown and JSON files. Any AI tool that can read or write files can manage your board. Pick your tool below for a step-by-step guide.
Full filesystem access + CLI integration. The deepest Postal integration available.
Agent mode reads and writes files. Manage tasks alongside your code.
Desktop app can read your workspace and generate task files directly.
Agent mode in VS Code creates and modifies task files natively.
Cascade agent can read AGENT.md and create tasks in your workspace.
Research anything in Perplexity, then capture it into Postal with one command.
Every integration follows the same principle: Postal stores tasks as files. Your AI writes files. The board updates within one second.
postal CLIEvery AI agent that has terminal access can capture notes and tasks with a single command. No file format knowledge needed.
~/.local/bin/postal "Buy groceries"
~/.local/bin/postal --label Work --type task "Deploy v2"
~/.local/bin/postal --due 2026-04-01 "File taxes"
echo "Research notes" | ~/.local/bin/postal
The CLI writes directly to your workspace on disk.
Postal detects the change within ~1 second.
Installed at ~/.local/bin/postal.
For AI tools with filesystem access, AGENT.md documents the complete file format — workspaces, projects, tasks, labels, and metadata. Drop it into your project root and your AI agent will reference it automatically.
workspace/
.workspace.json # Workspace config + labels
Default Project/ # Project folder
.project.json # Task metadata (JSON)
k7m2x9pq/ # Task folder (8-char ID)
content.md # Title (# heading) + Markdown notes
attachments/ # Any filesFull spec ships with every copy of Postal. See the format reference for details.
Download Postal and start managing tasks with your AI assistant today.