Claude Code Plugin

Use taskmd directly inside Claude Code with slash commands. The plugin provides skills for listing, creating, completing, and validating tasks without leaving your Claude session.

Prerequisites

The taskmd CLI must be installed and available in your PATH. See Installation for setup instructions.

Installation

There are two plugins available:

Plugin	What it provides	Requires CLI?
taskmd	Slash command skills (/taskmd:do-task, /taskmd:next-task, etc.) that orchestrate task workflows by invoking the taskmd CLI	Yes
taskmd-mcp	An MCP server that exposes task operations as tools (list, get, next, search, set, etc.), letting Claude call taskmd directly through the Model Context Protocol	Yes

taskmd is best for interactive, human-driven workflows via slash commands. taskmd-mcp gives Claude direct tool access for autonomous task operations. You can install both.

First, add the taskmd marketplace:

claude plugin marketplace add driangle/taskmd

Then install the plugin(s):

# Install slash command skills
claude plugin install taskmd@taskmd-marketplace --scope project

# Or install for all projects (user-wide)
claude plugin install taskmd@taskmd-marketplace --scope user

# Or install for the current directory only
claude plugin install taskmd@taskmd-marketplace --scope local

MCP Server Plugin (Optional)

For direct tool access without shelling out to the CLI, install the MCP plugin:

claude plugin install taskmd-mcp@taskmd-marketplace --scope project

Available Skills

Slash Command	Description
/taskmd:do-task <ID>	Look up a task and start working on it
/taskmd:next-task	Find the next recommended task
/taskmd:get-task <ID>	View task details by ID or name
/taskmd:add-task <description>	Create a new task file
/taskmd:complete-task <ID>	Mark a task as completed
/taskmd:list-tasks	List tasks with optional filters
/taskmd:validate-tasks	Validate task files for errors

Usage

Find your next task

/taskmd:next-task

Pass flags to filter results:

/taskmd:next-task --filter tag=mvp
/taskmd:next-task --quick-wins
/taskmd:next-task --critical --limit 3

Work on a task

/taskmd:do-task 015

This looks up the task, marks it as in-progress, works through the subtasks, and marks it completed when done. For non-trivial tasks, Claude will enter plan mode first.

List tasks

/taskmd:list-tasks
/taskmd:list-tasks --status pending
/taskmd:list-tasks --filter priority=high --format json

View a specific task

/taskmd:get-task 042
/taskmd:get-task authentication

Create a task

/taskmd:add-task Add rate limiting to the API endpoints

Claude will determine the next available ID, choose the appropriate subdirectory, and create the task file with proper frontmatter.

Complete a task

/taskmd:complete-task 015

Validate task files

/taskmd:validate-tasks
/taskmd:validate-tasks --format json

Troubleshooting

"taskmd: command not found"

The CLI is not installed or not in your PATH. Install it:

brew tap driangle/tap && brew install taskmd

Or see Installation for other methods.

"no task files found"

Ensure you have a tasks/ directory with .md files in your project, or configure the default directory in .taskmd.yaml:

dir: ./tasks

Skills not appearing

Verify the plugin is installed:

/plugins list

Source

The plugin source lives in claude-code-plugin/ in the taskmd repository.