taskmaster
v7.0.0-rc.2Harness-agnostic task and backlog management with neutral workflow playbooks, narrative continuity, and a local kanban viewer.
By gruku0 GitHub starsUpdated 3 hours ago
Directory evidence
- Runtimes
- Codex and Claude Code
- Parsed components
- 18 skill or MCP entries
- Source updated
- Sep 30, 2026
- Manifest status
- Canonical path parsed
The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →
Install taskmaster for Codex and Claude Code
codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add taskmaster@agent-plugin-marketplacePaste and run these commands in a terminal with Codex. They add and refresh the PluginsMP catalog, then install this plugin.
Compatibility: the page URL and API slug “taskmaster-2” remain stable.
- Codex:
taskmaster-2@agent-plugin-marketplace→taskmaster@agent-plugin-marketplace
The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.
Get the source manually
git clone https://github.com/Gruku/taskmasterClone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.
Plugin files
├── .codex-plugin/plugin.json├── .claude-plugin/plugin.json├── skills/add-idea/SKILL.md├── skills/bug/SKILL.md├── skills/check-todos/SKILL.md├── skills/decision/SKILL.md├── skills/end-session/SKILL.md├── skills/handover/SKILL.md├── skills/init-taskmaster/SKILL.md├── skills/issue/SKILL.md├── skills/linear/SKILL.md├── skills/migrate-lessons/SKILL.md├── skills/migrate-v3/SKILL.md├── skills/pick-task/SKILL.md├── skills/plan-review/SKILL.md├── skills/review-gate/SKILL.md├── skills/spec-review/SKILL.md├── skills/start-session/SKILL.md├── skills/taskmaster/SKILL.md└── .mcp.json
Included Skills17
Log a lightweight idea into .taskmaster/ideas/. Triggers: '/add-idea', 'save this as an idea', 'remember this idea', 'log this idea', or something worth keeping, not yet a task. Only way - not backlog_idea_create directly.
Log/update/close project bugs in .taskmaster/bugs/. Triggers: 'log a bug', 'this is a bug', 'track this defect', 'I found a bug', 'shelve this for later', 'list open bugs', 'promote B-XX', 'close B-XX'. Also for ambiguous 'issue' phrasing lacking recurring/systemic/outstanding evidence - falls back here. Only correct way to transition a project Bug.
Scan the codebase for TODO/FIXME/HACK/XXX and cross-reference the backlog. Triggers: 'check todos', 'are my todos tracked', 'scan for todos', 'todo audit', 'what's untracked'.
Write/resolve/drop project decisions in .taskmaster/decisions/. Invoke when about to write an inline option menu - route here, not Options: in chat. Also 'choose between', 'pick an option', 'decide on', 'open question', 'resolve DEC-X', 'drop DEC-X'. Only correct way - do not call backlog_decision_create directly.
Close out a work session. Triggers: 'end session', 'I'm done for today', 'let's wrap up', 'mark this task done', 'save progress'. ONLY correct way to mark tasks done/in-review with a session record.
Write a session handover into .taskmaster/handovers/. Triggers: 'write a handover', 'wrap up', 'for tomorrow', 'before compaction', 'context handoff', 'continue where we left off'. Only way - not backlog_handover_create directly.
Set up Taskmaster in the current project. Triggers: 'set up taskmaster', 'initialize backlog', 'I want to track my work here', or backlog.yaml missing. Offers clean init or project analysis.
Log/update/close project issues in .taskmaster/issues/ - elevated tier for recurring, systemic, or P0/P1 outstanding defects. Triggers: 'log an issue', 'this is an issue', 'file an issue', 'promote to issue', 'is this an issue', 'list open issues', 'triage issues', 'mark issue fixed', 'close ISS-XX'. NOT for one-off bugs, route to taskmaster:bug. Colloquial 'issue' lacking that evidence routes to taskmaster:bug. Only correct way to transition a project Issue.
Manage Taskmaster's Linear sync. Triggers: 'set up linear sync', 'connect to linear', 'link/unlink task to linear', 'show linear status', 'retry linear pushes', 'list linear trackers'. Only way to drive backlog_linear - direct calls skip bootstrap.
Migrate legacy .taskmaster/lessons/ into assistant memory and repo instruction files after a taskmaster 4.x upgrade. Triggers: 'migrate lessons', 'convert lessons to memory', 'what happened to lessons', or start-session finding L-*.md files.
Guided v2 to v3 backlog migration. Triggers: 'upgrade to v3', 'migrate to v3', 'switch to v3', 'enable handovers', 'enable narrative continuity'. Only correct way - do not call backlog_migrate_v3 directly without the pre-flight gate.
Select a task to work on. Triggers: 'pick a task', 'let's work on X', 'start task auth-003', 'what should I tackle next', 'continue this task', 'continue where we left off', a task ID, 'pick this bundle', 'cluster these tasks'. Sets status in-progress, checks deps, creates worktree.
Review a task's implementation plan before writing tests. Triggers: 'review this plan', 'plan review', 'challenge my plan', 'is this plan solid'. Full-lane gate between PLAN and WRITE_TESTS; post-implementation review is taskmaster:review-gate.
Run quality checks on a task's implementation before it closes to done. Triggers: 'is this ready?', 'run the review gate', 'check my work', 'I think this is done'. Reviews code + spec adherence, runs tests/build. Design review uses taskmaster:spec-review.
Pre-implementation design review of a task's spec. Triggers: 'review this spec', 'challenge this design', 'is this the right approach?', 'spec review', 'design review'. Records the spec-review (full) or design-review (standard) gate. Code review uses taskmaster:review-gate.
Start a work session, orient a new conversation. Triggers: 'let's get started', 'what should I work on', 'show me the backlog', 'orient me', or a new conversation where backlog.yaml exists. Shows dashboard, last session, next tasks.
Universal taskmaster work router for projects with backlog.yaml. Invoke for features, bug fixes, tests, refactors, epic planning, or narrative-continuity work (handovers, issues). Skip only for: pure git commits, dedicated PR security reviews, and small direct changes asked for outright (one sitting, no open design decisions, ~<=3 files).
MCP servers1
- command
- uv
- args
- run backlog_server.py
- cwd
- .
Plugin manifests2
{
"name": "taskmaster",
"version": "7.0.0-rc.2",
"description": "Harness-agnostic task and backlog management with neutral workflow playbooks, narrative continuity, and a local kanban viewer.",
"author": {
"name": "gruku"
},
"skills": "./skills/",
"mcpServers": {
"tm": {
"command": "uv",
"cwd": ".",
"startup_timeout_sec": 120,
"tool_timeout_sec": 30,
"args": [
"run",
"backlog_server.py"
]
}
},
"interface": {
"displayName": "Taskmaster",
"shortDescription": "Harness-agnostic task and backlog management.",
"longDescription": "Manage tasks, epics, areas, bugs, issues, decisions, handovers, and project manifests through an assistant-neutral MCP core and workflow playbooks. Codex receives the verified core and advisory workflow layers; Claude-only enforcement hooks are intentionally excluded.",
"developerName": "gruku",
"category": "Productivity",
"capabilities": [
"Task management",
"Workflow playbooks",
"Narrative continuity",
"Kanban viewer"
],
"defaultPrompt": [
"Show me the Taskmaster backlog and orient this session.",
"Pick the next ready task and explain why it is next.",
"Review the current task against its completion criteria."
]
}
}{
"name": "taskmaster",
"description": "Latest channel — v4 sharded storage (default). Universal AI-powered task and backlog management plus narrative continuity: handovers, issues. Per-task files (.taskmaster/tasks/<id>.md) with a slim YAML index and dirty-scoped, merge-aware saves. v2/v3 backlogs keep working unchanged; migrate with `backlog_migrate_v4`. Requires: uv (https://docs.astral.sh/uv/)",
"version": "7.0.0-rc.2",
"channel": "latest",
"author": {
"name": "gruku"
}
}For maintainers
If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.
[taskmaster on Agent Plugins Marketplace](https://pluginsmp.com/plugins/taskmaster-2)