GitHub Copilot + Postal

Copilot's agent mode in VS Code has full file read/write access. Open your Postal workspace folder, ask Copilot to create or edit tasks, and watch them appear on your board. No plugins, no API keys, no setup.

How it works

Copilot's @workspace agent can read every file in your open project. When your Postal workspace is in the project, Copilot can read AGENT.md, understand the file format, and create or modify tasks directly on disk.

1

Open workspace in VS Code

Open your Postal workspace folder (or add it to a multi-root workspace). Copilot can now see every file in it.

2

Reference AGENT.md

Use @workspace to tell Copilot to read AGENT.md. This gives it the full file format spec for creating tasks.

3

Ask for what you need

Tell Copilot to create, edit, or organize tasks. It writes the files, Postal detects the change within ~1 second.

Examples

Copilot's agent mode handles everything from creating single tasks to bulk operations across your board.

Create a task

Agent Mode

Ask Copilot to read the format spec and create a task in one prompt. It handles folder creation, content.md, and .project.json updates.

Copilot Chat prompt
@workspace Read AGENT.md and create a task called
"Migrate to React 19" in my Postal workspace with
notes about the breaking changes we need to handle.
What Copilot does
1. Reads AGENT.md to learn the file format
2. Reads .workspace.json to find the project path
3. Reads .project.json for existing task metadata
4. Creates a new folder with an 8-char ID
5. Writes content.md with the title and notes
6. Updates .project.json with the new task entry
   → Task appears on your Postal board within 1 second

Edit an existing task

Agent Mode

Copilot can find and modify existing tasks by reading the project metadata and updating the relevant content.md file.

Copilot Chat prompt
@workspace Find the task called "Migrate to React 19"
in my Postal workspace and add a checklist of the
specific dependencies that need updating.

Bulk create from code TODOs

Agent Mode

One of the most powerful patterns: let Copilot scan your codebase for TODOs and create Postal tasks for each one.

Copilot Chat prompt
@workspace Find all TODO comments in the src/ folder.
For each one, create a task in my Postal workspace
following the AGENT.md format. Include the file path
and line number in the task notes.

Mark tasks complete

Agent Mode

After finishing work, ask Copilot to update the task status in .project.json.

Copilot Chat prompt
@workspace Read the AGENT.md format, then mark the
task "Fix login bug" as completed in my Postal
workspace.

Tips for the best experience

Use @workspace

The @workspace agent gives Copilot full file read/write access to your project. Always start prompts with it for task management.

Keep AGENT.md in root

Drop Postal's AGENT.md into your project root so Copilot can always reference the file format without you explaining it.

Multi-root workspaces

Add your Postal workspace folder alongside your code repo in a VS Code multi-root workspace. Copilot sees both.

No extensions needed

Copilot's built-in agent mode is all you need. No marketplace extensions, no configuration files, no setup wizard.

Get started free

Download Postal and start managing tasks with GitHub Copilot today.