The task manager for Windsurf

Give Windsurf's Cascade agent a real task queue. TaskPrio is MCP-native — Cascade pulls the top task with get_next_task, works it in your codebase, reports a result, and grabs the next. One priority order, worked top to bottom — watched live in a cockpit.

Add it to Windsurf

First fetch the bundled server and verify your token (one-time — grab the token from the TaskPrio sidebar → Copy token):

PROMPTPRIO_API_TOKEN=pp_xxx bash <(curl -fsSL https://promptprio.com/install.sh)

That caches the MCP server to ~/.local/share/promptprio/mcp-server.js. Now add it to Windsurf — open Windsurf → Settings → Cascade → MCP servers (or edit ~/.codeium/windsurf/mcp_config.json directly) and add promptprio under mcpServers:

{
  "mcpServers": {
    "promptprio": {
      "command": "node",
      "args": ["/Users/you/.local/share/promptprio/mcp-server.js"],
      "env": {
        "PROMPTPRIO_API_TOKEN": "pp_your_token",
        "PROMPTPRIO_API_URL": "https://taskprio.com"
      }
    }
  }
}

Hit refresh in the MCP panel — Cascade now has the TaskPrio tools. Full steps in the docs.

The autopilot loop

1. get_next_task     → top unblocked task + merged project context
2. (Cascade edits your codebase)
3. complete_task     → short result, logged for the audit trail
4. repeat            → until the queue returns no task

Each handed-out task is leased, so you can run Windsurf alongside a Claude Code or Cursor session on the same queue without two agents grabbing the same task.

Why developers pair Windsurf with TaskPrio

• No prompt babysitting — Cascade pulls work itself instead of you typing the next instruction each turn.
• One source of truth — the same ranked queue you see on the web board is the one Cascade reads.
• Context travels with the task — project instructions are merged into every task the agent receives.
• You set priority — capture into the Inbox, rank what matters; Cascade only works ranked tasks.

Frequently asked questions

How do I add a task queue to Windsurf?

Run the one-line installer, enable the promptprio server in Windsurf's MCP settings (Settings → Cascade → MCP servers), and hit refresh. Cascade then has get_next_task and complete_task.

Does it work with Cascade?

Yes — Cascade loops get_next_task → work → complete_task on your queue, the same autopilot loop Claude Code and Cursor use.

Is it free?

Yes. Free includes 1 MCP session and 50 completions/day; Pro ($10/mo) gives 5 sessions and unlimited completions.

Start free — no card →   Using Cursor? →