markplane

Overview

Markplane transforms project management by integrating directly into code repositories. It stores all project data as markdown files within the .markplane directory, allowing for version control alongside code. The tool compresses project state into token-efficient summaries for AI consumption via its built-in MCP server. The web UI provides visualization of tasks, epics, and dependencies while AI assistants can manage project elements through natural language commands.

Try asking AI

After installing, here are 3 things you can ask your AI assistant:

• create_task

  Create a new task with title, type, priority and other attributes

  Try:Create a task for the login bugTry:Add a new high-priority task for database optimization
• list_tasks

  List tasks with optional filters like priority

  Try:Show me all tasksTry:List high and critical priority tasks
• show_task

  View details of a specific task by ID

  Try:Show details for TASK-fq2x8Try:Display information about the auth epic
• start_task

  Mark a task as in-progress

  Try:Start working on TASK-fq2x8Try:Put the login task in progress
• complete_task

  Mark a task as done

  Try:Mark TASK-fq2x8 as doneTry:Complete the database migration task
• show_project_summary

  Get a compressed summary of the entire project state

  Try:What should we work on today?Try:Show me the project overview
• show_blocked_items

  List items waiting on unresolved dependencies

  Try:What's blocked right now?Try:Show me tasks that can't progress
• create_epic

  Create a new epic for strategic goals and phases

  Try:Create an epic for the authentication systemTry:Add a new Q4 epic for feature development
• show_dependencies

  Show dependency graph for a specific item

  Try:Show dependencies for the auth epicTry:Display what blocks the payment task
• create_plan

  Create a new plan with implementation details

  Try:Create a plan for the onboarding featureTry:Build out the implementation plan for the API redesign
• search_items

  Search across all project items by text or tags

  Try:Find tasks related to authenticationTry:Show me items with the bug tag
• sync_context

  Regenerate project summaries and index files

  Try:Update the project contextTry:Refresh the summaries

Comparable tools

Installation

brew install zerowand01/markplane/markplane

curl -fsSL https://raw.githubusercontent.com/zerowand01/markplane/master/install.sh | sh

{
  "mcpServers": {
    "markplane": {
      "command": "markplane",
      "args": ["mcp"]
    }
  }
}

On Hacker News

Recent discussion from the developer community.

• Show HN: Markplane – Project management in your repo, built for AI collaboration▲ 1💬 1
  Story by ddkingsley · 2026-04-15

Compare markplane with