For developers
Copy one snippet into your tool's config file. Your AI assistant starts managing your Postal tasks immediately — no plugins, no API keys, no setup.
Postal stores tasks as plain files on disk. Any AI tool that can read and write files can create tasks, add notes, and check things off your board. The snippets below tell your AI where your workspace lives and how to use it.
Each snippet points to AGENT.md in your workspace
root, which documents the full file format. Drop the right
snippet into the right file and you're done.
Add this to your project's CLAUDE.md or your
global ~/.claude/CLAUDE.md. Claude Code reads
it automatically at the start of every session.
Paste into CLAUDE.md
# Postal Integration
Track tasks and notes using Postal (https://postal.wtf).
Workspace location: ~/Postal/
Task format is documented in AGENT.md at the workspace root.
Quick actions:
- Create task: Run `postal "task description"`
- Create task with label: Run `postal --label Work "task description"`
- Create note: Run `postal --type note "content"`
- Create research item: Run `postal --type research "topic"`
For file-based access, see AGENT.md in the workspace root for the
full spec: folder structure, task format, how to create/read/complete tasks.
Add this to .cursorrules in your project root.
Cursor's agent reads it before every response, so it
always knows where your tasks live.
Paste into .cursorrules
# Postal Integration
This project uses Postal (https://postal.wtf) for task management.
Workspace location: ~/Postal/
The task format spec is in AGENT.md at the workspace root.
When the user asks to create, update, or complete tasks:
- Use the `postal` CLI: `postal "task description"`
- Add labels with: `postal --label Work "task description"`
- Add notes with: `postal --type note "content"`
For direct file manipulation, read AGENT.md in the workspace root.
It documents folder structure, JSON metadata, and content.md format.
Create .github/copilot-instructions.md in your
repo. Copilot's chat and agent mode will pick it up
automatically in VS Code.
Paste into .github/copilot-instructions.md
# Postal Integration
This project tracks tasks with Postal (https://postal.wtf).
Workspace location: ~/Postal/
Full task format spec: see AGENT.md at the workspace root.
To manage tasks:
- Create task: Run `postal "task description"`
- Create task with label: Run `postal --label Work "task description"`
- Create note: Run `postal --type note "content"`
For file-based operations (reading tasks, marking complete, bulk edits),
refer to AGENT.md which documents the folder structure, .project.json
schema, and content.md format.
Add this to GEMINI.md in your project root.
Gemini CLI reads it for project context, just like
Claude Code reads CLAUDE.md.
Paste into GEMINI.md
# Postal Integration
Track tasks and notes using Postal (https://postal.wtf).
Workspace location: ~/Postal/
Task format is documented in AGENT.md at the workspace root.
Quick actions:
- Create task: Run `postal "task description"`
- Create task with label: Run `postal --label Work "task description"`
- Create note: Run `postal --type note "content"`
For file-based access, see AGENT.md in the workspace root for the
full spec: folder structure, task format, how to create/read/complete tasks.
Use the postal CLI directly from any script,
cron job, or CI pipeline. No dependencies beyond the
binary.
Examples
# Create a task
postal "Fix login bug on mobile"
# Create a task with a label
postal --label Work "Prepare Q2 roadmap"
# Create a note
postal --type note "Met with Sarah — agreed on new timeline"
# Create a research item
postal --type research "Compare Postgres vs SQLite for mobile sync"
# Set a due date
postal --label Work --due 2026-04-10 "File quarterly taxes"
# Pipe from other tools
gh issue list --json title -q '.[].title' | while read t; do
postal --label GitHub "$t"
doneDownload the app, drop a snippet into your config, and your AI starts managing your tasks.
Full file format documentation lives in AGENT.md
inside every Postal workspace. See
AI Integration for the complete
spec.