Integrations › Windsurf
Windsurf is an AI IDE by Codeium with a powerful Cascade
agent that has full filesystem access. Open your Postal
workspace folder and Cascade can read
AGENT.md, create tasks, edit notes, and
organize your board — all through natural language.
Windsurf's Cascade agent works similarly to Cursor's agent mode. It can read and write any file in your open project. When your Postal workspace is in the project, Cascade becomes your task management assistant.
Open your Postal workspace folder as a project in
Windsurf. Cascade can now see every file including
AGENT.md and all task data.
Ask Cascade to read the AGENT.md file.
It learns the file format — workspaces,
projects, tasks, folder structure, JSON schema.
Tell Cascade what you need in plain English. It creates folders, writes Markdown, updates JSON. Postal detects the change within ~1 second.
Cascade's agentic capabilities make it easy to manage your entire task board without leaving the IDE.
Ask Cascade to read the format spec and create a task. It handles all the file operations automatically.
Read the AGENT.md file in this project, then create
a task in my Postal workspace called "Refactor auth
middleware" with notes about switching to JWT tokens.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 secondCascade has deep awareness of your code. Ask it to create tasks based on what it sees in the codebase.
Look at the TODOs and FIXMEs in the src/ directory.
Create a Postal task for each one following the
AGENT.md format. Include the file path and context
in the task notes.After finishing a piece of work, ask Cascade to update the relevant task with implementation details.
I just finished the auth middleware refactor. Find
that task in my Postal workspace and update the notes
with what was changed. Then mark it as completed.Cascade also has terminal access. For quick captures, it can use Postal's CLI directly.
Run this command to capture a task:
~/.local/bin/postal --label Work "Add rate limiting to API"Cascade can read and write any file in your project. No API keys, no plugins, no authentication flows. Just open the folder.
Unlike standalone AI tools, Windsurf understands your codebase. Tasks can reference specific files, functions, and context.
If you've used Cursor with Postal, the Windsurf experience is nearly identical. Same file-based approach, same AGENT.md format.
Cascade can both write files directly and run terminal commands. Use whichever approach fits your workflow — or mix both.
Download Postal and start managing tasks with Windsurf's Cascade agent today.