Taskr for VS Code
The most advanced task manager for your AI, right in your editor.
Taskr gives your AI a super-organized task manager with persistent history. This extension brings Taskr's task tree directly into VS Code, so you can watch your AI work through projects in real-time. Every task, every decision — always there so nothing gets lost across long-horizon projects.
🤖 What is Taskr?
Taskr is a cloud-backed task manager that your AI assistant reads and updates automatically. It gives your AI a perfect memory and advanced task management capabilities:
- 🧠 Never forgets context — Your AI remembers exactly where it left off, even days later
- 💻 Continue anywhere — Pick up where you left off on any machine or IDE
- 🎯 Works in order —
get_task enforces single-task focus so your AI doesn't skip around or lose track
- 📝 Documents everything — Typed notes capture what files changed, decisions made, and problems solved
- 🔧 12 MCP tools — A full toolkit for creating tasks, managing hierarchies, and keeping structured notes
☁️ Why Taskr over local task files?
Most AI task tools store tasks in local JSON or markdown files that get lost, overwritten, or stuck on one machine. Taskr is different:
- 🔄 Cloud-synced — Tasks live in the cloud, not fragile local files. Switch machines, switch IDEs, pick up exactly where you left off.
- 🌐 Works across IDEs — VS Code, Cursor, Claude Desktop, Windsurf, OpenClaw, or any MCP-compatible client. Your tasks follow you everywhere.
- ⚡ Real-time, not polling — Live WebSocket updates via Supabase Realtime. See your AI complete tasks the instant it happens.
- 🏗️ Built for long projects — Persistent task history means you can run multi-day, multi-session projects without losing a single decision or context switch.
Taskr gives your AI 12 purpose-built MCP tools, organized into two categories:
Task Management
| Tool | What it does |
|------|-------------|
| create_task | Create tasks, subtasks, or entire hierarchies in one call |
| update_task | Change status or batch-update up to 50 tasks at once |
| delete_task | Soft delete with confirmation — nothing is lost permanently |
| get_task | Get the next task, enforcing single-task focus so your AI stays on track |
| get_task_hierarchy | Navigate the full task tree with scope and depth control |
| task_sync | Retroactively log completed work into the task hierarchy |
Notes & Documentation
| Tool | What it does |
|------|-------------|
| create_note | Create typed notes (file changes, progress, context, findings, general) |
| update_note | Update content or reassign notes between tasks |
| delete_note | Soft delete with confirmation |
| list_notes | List and filter notes, including across subtask descendants |
| get_note | Retrieve full note content |
| search_notes | Full-text search across all notes |
🧭 Embedded Rule System
Taskr doesn't just give your AI tools — it gives your AI guidance. Behavioral rules are embedded directly into MCP tool calls, so your AI knows how to use each tool correctly. Pre-execution rules guide actions before they happen. Post-execution rules shape what comes next. No prompt engineering required on your end.
📒 Notes — Your AI's Documentation Engine
Notes aren't just comments. They're a structured record of everything your AI does:
- 📁 FILE_LIST — What files were created, modified, or deleted
- 📊 PROGRESS — Status updates and milestone markers
- 💡 CONTEXT — Background information and rationale for decisions
- 🔍 FINDING — Issues discovered, edge cases, or important observations
- 📌 OTHER — Everything else
Notes attach to tasks, creating a complete audit trail. Search across all notes with full-text search. Filter by type. View notes for an entire subtree of tasks at once.
✨ Extension Features
🌳 Task Tree View
- Hierarchical task display with nested subtasks and expand/collapse
- Real-time updates as your AI works — no refresh needed
- Status indicators: open, in progress, done, skipped
- Progress bar showing completion percentage per task list
- Right-click context menu for quick actions
📋 Task Details Panel
- Full task description with created/updated timestamps
- Resizable split view with draggable divider
- All notes for the task and its descendants in one place
- Filter notes by type or search by title
📂 Project Management
- Switch between projects instantly from the sidebar
- Create new projects without leaving the editor
- Status bar indicator showing your current project
- Auto-configures MCP connection in your workspace
📝 Notes & Documentation
- View notes your AI creates as it works
- Five note types: file changes, progress, context, findings, and general
- Notes attached to tasks create a complete history
- Track what files changed, decisions made, and problems solved
⚡ Real-time Sync
- Live WebSocket updates — not polling
- Instant status changes, note counts, and progress updates
- Works across multiple open editors simultaneously
🚀 Getting Started
- Install the extension from the marketplace
- Sign in with your Taskr account (secure device code flow)
- Select a project from the dropdown
- Watch as your AI works through tasks in real-time
Your MCP configuration is set up automatically — no manual JSON editing needed.
Requirements
Commands
Taskr: Sign In — Sign in via secure device code flow
Taskr: Sign Out — Sign out and clear session
Taskr: Switch Project — Change the active project
📚 Learn More