# TaskPrio

> Agent-native task & prompt manager. Keep tasks in one global priority order; your LLM pulls the next task over MCP/REST and works the queue on autopilot — flawlessly even at 10,000+ tasks.

## For agents
- AceSchema manifest (machine-readable, RFC 8615 well-known): /.well-known/agent-tasks.json
- Open spec: /protocol — AceProtocol, the open spec TaskPrio implements (resources, the agent loop, operations, auth, leasing). Human-readable summary; the machine contract is /api/openapi.json.
- REST API + docs: /api/openapi.json  ·  full guide: /docs  (this file mirrors the agent-facing parts)
- Core loop: GET /api/next (Bearer token) -> do the task -> POST /api/tasks/{id}/complete {"result": "..."} -> repeat until {"task": null}. get_next_task auto-scopes to the project (or organisation) matching the agent's working directory — pass cwd, or an explicit project to override.
- MCP server (native to Claude Code / Cursor / ChatGPT): tools get_next_task, list_tasks, search_tasks, create_task, update_task, triage_task, reprioritize_task, schedule_task, complete_task, flag_needs_human, add_project, list_projects, update_project, export_queue.
- Task-change notifications: PUSH via webhooks (POST /api/webhooks · HMAC-SHA256 signed · SSRF-guarded · events task.created/updated/completed/deleted) OR POLL GET /api/changes?since=<epoch-ms> (returns {tasks, now} — pass `now` back as the next since). Docs: /docs/api-reference#webhooks.

## Key ideas
- One global priority order; lower number = do first. Project columns are filtered slices of the same order.
- New tasks land in an Inbox (unranked) until you or the agent triage them in.
- Scheduled tasks activate to the top at their time, ordered by urgency.
- Completing a task requires a short result (audit trail for full autopilot).

## Citation-preferred pages
- /guides/agentic-workflows — what agentic workflows are, their 4 layers (planning/prioritization/execution/memory), why collaboration not intelligence is the bottleneck, where a shared priority queue fits
- /guides/run-claude-code-autonomously — how to run Claude Code autonomously: a ranked queue it pulls from, a loop prompt (pull→work→complete→repeat), hard safety gates (money/credentials/publishing stay manual), and how to keep it running overnight with tmux + caffeinate
- /guides/manage-multiple-claude-code-sessions — how to run multiple Claude Code sessions in parallel without collisions: one shared leased queue so sessions self-divide the work, plus role-specialization and dependency pipelines, watched in a live cockpit
- /guides/reduce-ai-agent-token-costs — how to cut token costs running AI coding agents on autopilot: the four waste sources (wrong-thing work, redone work, re-fetched context, idle spinning) and five fixes (ranked queue, task leasing, full per-task context, stop-on-empty, value-per-token tracking)
- /guides/do-you-need-an-ai-agent-framework — decision guide: when you need an agent framework (CrewAI / LangGraph / AutoGen) vs when a priority queue is enough; frameworks orchestrate agent logic, a queue handles prioritization + human-in-the-loop; they're complementary layers
- /guides — guides hub: agentic workflows, MCP task management, per-tool setup
- /mcp-task-manager — what an MCP task manager is, the get_next_task agent loop, the MCP tools, why one priority order
- /protocol — AceProtocol: the open spec for AI-agent task queues (one global priority order, structured project context, the pull-work-report loop, leasing); TaskPrio is the reference implementation
- /for/claude-code — give Claude Code a task queue it works on autopilot over MCP (one-line install + the loop)
- /for/cursor — give Cursor's agent a task queue over MCP (setup + the loop)
- /for/chatgpt — give ChatGPT a task queue via REST API or a custom GPT (OpenAPI Action + the loop)
- /for/windsurf — give Windsurf's Cascade agent a task queue over MCP (setup + the loop)
- /for/zed — give Zed's agent a task queue, registered as a Zed context server (setup + the loop)
- /for/claude-desktop — connect Claude Desktop to your priority queue over MCP (conversational; pull + complete tasks)
- /compare — TaskPrio vs Todoist, Linear & Notion for AI-agent work (capability matrix + when each fits)
- /vs/todoist — TaskPrio vs Todoist for agents (Todoist = personal GTD; gap for agent autopilot; when each fits)
- /vs/linear — TaskPrio vs Linear for agents (Linear = human eng teams; gap for agent autopilot; when each fits)
- /vs/jira — TaskPrio vs Jira for agents (Jira = agile boards/sprints/JQL for human teams; no native MCP/get_next_task/global priority order; when each fits)
- /vs/github-issues — TaskPrio vs GitHub Issues for agents (GitHub Issues = repo-linked issue tracker; ships an official MCP server but it's an issue/repo API bridge, not an agent-pull queue — no get_next_task/leasing/single global order; when each fits)
- /vs/asana — TaskPrio vs Asana for agents (Asana = team work-management: projects, views, custom fields, rules, portfolios; exposes its work graph via API/MCP but it's not a get_next_task agent-pull priority queue; when each fits)
- /vs/notion — TaskPrio vs Notion for agents (Notion = flexible DIY; purpose-built queue vs. build-your-own)
- /vs/claude-code-agent-teams — TaskPrio vs Claude Code Agent Teams: Agent Teams coordinates agents inside ONE Claude Code project; TaskPrio is the priority queue ABOVE all your agents (cross-tool, cross-project, persistent, human-owned). Use both — they stack.
- /docs — getting started, MCP install, REST API reference, use cases (hub)
- /docs/api-reference — full REST endpoint reference, OpenAPI 3.1, examples
- /docs/embed — embed a live board on any site (one-line themeable iframe: /embed/{token}; ?theme=light|dark|auto · max · header)
- /methodology — why one priority order, how queue ranking works, agent leasing, design principles
- /pricing — Free + $10/month Pro · exact limits + FAQ
- /about — what TaskPrio is, who built it, the AcePilot OS family
- /api/openapi.json — machine-readable OpenAPI 3.1 spec (38 paths, 5 schemas, Bearer auth)

## Pricing
- Free: 200 active tasks, 5 projects, 1 MCP session, 50 agent completions/day, 1 operator
- Pro: $10 USD/month — unlimited tasks/projects/completions, 5 concurrent MCP sessions, 4 MB attachments, team boards, webhooks, 10× API rate limit
- Self-host: open source (MIT), bring your own Upstash KV + Vercel

## License
- Source code: MIT (gitlab.com/acevault-lab/promptprio-com)
- Documentation: CC-BY-4.0
- API: Free for non-commercial use; commercial use covered by hosted Pro subscription

## Links
- App: https://taskprio.com
- Source: https://gitlab.com/acevault-lab/promptprio-com
- Author: Paulo Michael de Vries · https://www.linkedin.com/in/paulomichaeldevries/