cotask
By wbopan
Manage project tasks with a TASKS.md kanban board using natural language: add tasks or sections, mark them ongoing or done, track progress via status symbols and acceptance criteria. Launch a local Node.js dashboard at localhost:3847 for visual overview with PWA install.
npx claudepluginhub wbopan/cotask-marketplace --plugin cotaskComponent Overview
Component Details
Skills (4)
Task management conventions for TASKS.md files. Use this skill whenever you are about to create, edit, update, or modify tasks in a TASKS.md file — including marking task status, adding new tasks, writing acceptance criteria, or restructuring sections. Also trigger when the user mentions TASKS.md, asks to add a todo, track progress, or manage task status. Even if you're just marking a single task as done, consult this skill first.
Create a new task or section in TASKS.md. Use this whenever the user wants to add, plan, or track work — even if they don't say "task" explicitly. Trigger on "add a task", "new task", "track this", "we should", "let's plan", "add a section", "create section", "I need to", "todo", "can you add", "put this on the board", or when the user describes future work that isn't in TASKS.md yet. Also use when creating a TASKS.md from scratch for a new project. When in doubt, use it — untracked work is invisible work.
Start the Cotask Dashboard and show the link for the user to open
Start working on a task — marks it ongoing in TASKS.md and begins execution. Use this whenever starting a task, beginning work, picking up a task, or when the user says "start", "work on", "do", "let's do", "begin", or references a task by slug. Also use when the user asks to "start task X" or just drops a task slug like "#fix-auth". Trigger on "/starting-task" too. If in doubt whether to use this, use it — it's the right entry point for any task execution.
Hooks (1)
README
Cotask
Easy parallel project management for Claude Code agents.
Why Cotask
-
A skill and a dashboard for your TASKS.md. Cotask is a Claude Code skill that manages tasks through a single
TASKS.mdfile. Both you and your agents read and update it. A local web dashboard lets you view, drag-and-drop, and edit tasks intuitively. -
Driven by project management best practices. Each task has acceptance criteria that define what "done" looks like, and a completion memo where the agent records what it actually did. Tasks follow a clear lifecycle — backlog, todo, ongoing, done, each serving clear purpose.
-
Monitor and navigate your running sessions. When a task is ongoing and bound to an active Claude Code session, the dashboard shows its state in real-time — running, idle, or waiting for permission. Click to jump straight to that terminal session.
Design Philosophy
-
Human-in-the-loop, not human-out-of-the-loop. Cotask is not about making agents fully autonomous. It's about letting you manage and intervene more efficiently — define what needs to be done, set the acceptance criteria, and approve when it's done.
-
The right interface for each species. Humans get a visual web dashboard. Agents get a structured skill that reads and writes markdown. Same underlying data, two interfaces, each suited to how its species operates.
-
More parallel work, less cognitive overhead. Managing multiple agents across multiple tasks is mentally taxing. Cotask consolidates everything into one view, shows you what needs your attention, and lets you navigate to any session directly.
Getting Started
1. Install the plugin
claude plugins marketplace add wbopan/cotask-marketplace
claude plugins install cotask@cotask-marketplace
2. Create your first task
Open any project in Claude Code and run:
/creating-task Set up project README
This creates a TASKS.md file in your project with your first task.
3. Open the dashboard
/dashboard
Claude will start the dashboard server and open it in your browser.
4. Work on tasks
Tell Claude to start a task by slug:
/starting-task #set-up-project-readme
Claude marks the task as ongoing, understands the requirements, plans the approach, then executes. The dashboard updates in real-time as work progresses.
Commands
| Command | Description |
|---|---|
/dashboard | Start the dashboard server and open it in the browser |
/creating-task <description> | Create a new task in TASKS.md |
/starting-task #slug | Mark a task as ongoing and begin working on it |
/cotask | View the full TASKS.md convention reference |
How It Works
Cotask tracks tasks in a TASKS.md file at the project root using a simple markdown format:
# TASKS
Project description here.
- [ ] Add user authentication #add-auth
Implement OAuth2 login flow.
AC: Users can log in with Google and GitHub accounts.
- [/] Fix search performance #fix-search
Search queries over 1s need optimization.
AC: Search returns results in under 200ms.
- [x] Set up CI pipeline #setup-ci
CM: Configured GitHub Actions with lint, test, and build steps.
AC: PRs run tests automatically before merge.
Status symbols: [ ] todo, [/] ongoing, [x] done, [-] backlog.
Requirements
- macOS — project discovery and session monitoring use macOS-specific APIs (Keychain, AppleScript).
- Node.js (v18.19+) — used as the runtime for the dashboard server.
- Ghostty (optional) — the "jump to terminal session" feature uses Ghostty's AppleScript API. Without Ghostty, all other features work normally.
License
Similar Plugins
taskyou
Install and manage TaskYou — a personal task management system with Kanban board, background AI execution, and git worktree isolation.
Matches all tools
Hooks run on every tool call, not just specific ones
Help us improve
Share bugs, ideas, or general feedback.