mcp-tasker

# Tasker [](https://github.com/greendwin/mcp-tasker/actions/workflows/ci.yml) A Markdown task tracker designed to live in git alongside your code. Tasks are plain Markdown files inside a `.tasker/` directory, with hierarchical stories and subtasks, a CLI for humans, and an MCP server so AI agents can manage the same task list. ## Installation Install with [pipx](https://pipx.pypa.io/) (recommended — installs in an isolated environment): ```bash pipx install mcp-tasker ``` Or with pip: ```bash pip install mcp-tasker ``` For development (requires [uv](https://docs.astral.sh/uv/getting-started/installation/)): ```bash git clone https://github.com/greendwin/mcp-tasker.git cd mcp-tasker uv sync --group dev ``` ## Quick Start ```bash # Initialize tasker (or let it auto-detect from any subdirectory) tasker init # Or initialize a user-level tasker in your home data directory tasker init --user # Create a story tasker new "Build authentication" # Add subtasks tasker add s01 "Design login flow" tasker add s01 "Implement JWT tokens" --details "Use RS256 signing" # Work on a task tasker start s01t01 # View what's on your plate tasker list # Mark tasks done tasker done s01t01 # Edit a task in your editor tasker edit s01t02 ``` Tasks are stored as Markdown in `.tasker/` and committed with your code: ``` .tasker/ s01-build-authentication/ README.md s01t01-design-login-flow.md s01t02-implement-jwt-tokens.md ``` ## Usage ### Create tasks ```bash tasker new <title> # new root story tasker new <title> --details "..." --slug <slug> # with description and slug tasker new <title> --editor # create and open in editor tasker add <parent-id> <title> # inline subtask tasker add <parent-id> <title> --details "..." # subtask with description tasker add <parent-id> <title> --editor # create and open in editor task…