# Waymark

Waymark — an MCP server for Claude Code that manages work items, dependencies, and project trees inside local repository files.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 43 repo stars
- Author: QiYueran-source
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/QiYueran-source/waymark/tree/HEAD/waymark/crates/waymark-mcp
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/waymark

## What it does

The tool connects the AI agent to a local tracker storing project items in Markdown files within Git. Communication happens over stdio without daemons, databases, or external network calls. The server supports reading metadata, updating statuses, managing dependencies, and schema migrations.

Running the server requires the `waymark-mcp` binary built via `cargo install waymark-mcp` or downloaded from the project release page.

## Requirements
- Needs: a prebuilt binary from the repository releases

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- query work items and inspect project statistics
- create new tasks and update their titles
- manage task dependencies and parent links
- validate project configuration and view git history

## Example prompts
- Show project stats using Waymark
- Create a new work item with title Fix parser bug
- List all blocked items in the repository

## Similar
- [receipts](https://affpapa.org/en/nevibecode/skills/receipts.md) — skill · 2052 installs
- [krimto](https://affpapa.org/en/nevibecode/mcp/krimto.md) — MCP server · ★ 7 repo stars
- [mnemodb](https://affpapa.org/en/nevibecode/mcp/mnemodb.md) — MCP server
- [obsidian](https://affpapa.org/en/nevibecode/skills/bitbonsai-obsidian.md) — skill · 1700 installs
- [wiki-update](https://affpapa.org/en/nevibecode/skills/wiki-update.md) — skill · 3400 installs
- [qmd](https://affpapa.org/en/nevibecode/skills/qmd.md) — skill · 4200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
