{"id":"zerowand01-markplane","name":"markplane","homepage":null,"repo_url":"https://github.com/zerowand01/markplane","category":"devtools","subcategories":[],"tags":["project-management","task-management","mcp","cli","rust","markdown","ai-context","web-ui","local-first"],"what_it_does":"Markplane is a local, markdown-first project management tool for organizing epics, tasks, plans, and notes inside a repository (e.g., .markplane/). It generates a token-efficient .context/ directory for AI assistants and includes a built-in MCP server (JSON-RPC over stdio) plus a local web UI to manage and visualize project state. ","use_cases":["Keep repo-scoped project plans/backlogs versioned with code in git","Provide an AI-friendly context layer (.context/ summaries + INDEX.md routing) for coding assistants","Manage tasks/epics/plans with CLI and sync updates to a local web dashboard","Use MCP-enabled AI assistants to query/update tasks and dependencies via natural language","Track dependencies/blocks between work items and surface blocked work","Maintain structured decision logs via markdown notes with status workflows"],"not_for":["Teams that require a hosted, multi-tenant SaaS workflow with centralized accounts","Organizations that need server-side RBAC/audit logs across many projects","Use cases that require an external database as the source of truth (Markplane is file-based)"],"best_when":"You want project management data to live in the same repo as the code (git-backed), and you want AI assistants to reliably read/update that state via an MCP integration and/or local UI/CLI.","avoid_when":"You cannot run local binaries/web UI/MCP locally (e.g., locked-down environments), or you need fine-grained, server-enforced access controls and external compliance features that are not provided by a local file-based model.","alternatives":["GitHub Projects / Issues / Projects (native tracking with external platform UI)","Linear (hosted issue/work management)","Notion (structured docs/database, hosted)","Jira (enterprise workflow + audit/RBAC)","Open-source markdown task trackers (file-based)","Other AI-integrated MCP project tools (if available)"],"af_score":58.5,"security_score":25.5,"reliability_score":28.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:20:52.085953+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["None for local CLI/Web UI and MCP transport is stdio-based (per README)"],"oauth":false,"scopes":false,"notes":"No hosted API/auth model is described. MCP integration is configured locally via editor config pointing to the `markplane mcp` command."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Licensing is Apache-2.0 per repo metadata; no usage-based pricing described in provided content."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":["Local filesystem/repository (no external SaaS described)"],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":58.5,"security_score":25.5,"reliability_score":28.8,"mcp_server_quality":78.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":90.0,"rate_limit_clarity":0.0,"tls_enforcement":20.0,"auth_strength":20.0,"scope_granularity":0.0,"dependency_hygiene":30.0,"secret_handling":60.0,"security_notes":"Local-first tool with no hosted service described; this reduces network attack surface but increases reliance on local environment safety. TLS is only relevant for the local web server; no documentation provided about TLS configuration. No auth/RBAC model is described for MCP/web UI (implies trust in local user/process). Dependency hygiene and secret handling practices are not verifiable from provided README alone.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":35.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":"Not described in provided content. CLI commands like `done/start` imply state transitions; idempotency behavior is not documented.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["MCP operates over stdio; some agent/editor setups may require correct per-user vs project-wide configuration (e.g., .mcp.json).","Agent may need to use INDEX.md routing/context-loading patterns described in docs to stay within token budgets.","File-based state means concurrent edits (manual + agent + UI) could create conflicts; conflict behavior is not described in provided content."]}}