mozak MCP server

One approved plan per project, shared by your coding agents, visible in Obsidian.

You work in ideas and plans, not code. Several agents share one plan without overwriting each other, and you follow their progress from your notes.

What it is · See it run · Install · How it works · Obsidian · Safety · Tested · Docs

See it run

The preview plays at double speed. In 76 seconds: you ask your agent in plain words, it reads the project and asks one question, drafts a plan and waits for your yes, records the test result, and the roadmap in Obsidian moves forward. The Obsidian side is a live capture of the plugin redrawing from the files. The terminal side is a rendered reenactment of the agent chat, with the same mozak commands run on disk. Click it for the full video with sound.

What it is

mozak gives every project one shared plan, stored as plain files in the project folder (or in your notes, for public repos). It does two jobs:

• Agents read the same plan. Agents that load the mozak skill or MCP server start from the same plan, so you don't have to paste the context into each one. Agents propose changes, but nothing becomes the plan until you approve it.
• You follow it from Obsidian. Every project's plan shows up in your vault with a roadmap and progress, so parallel work is visible in one place. You approve the next step. An outcome turns green when an agent records passing evidence, such as a test run it reports. mozak does not run the tests itself, and outcomes you mark as yours also need your sign-off.

Why you can trust it:

• It is just files. mozak.json holds the plan, mozak.md is a readable copy. They sit next to your README.md, and if the folder is in git, git keeps the history. No cloud, no account, no daemon.
• You stay in charge. Agreeing on what to do and agreeing to start building are two separate approvals.
• Many agents, no mess. A write made through mozak from an out-of-date copy is refused instead of overwriting someone else's work.
• Repos and notes together. A project can be a local folder, an Obsidian vault folder, or a GitHub repo you have not even cloned.

It is for developers and researchers who already use coding agents and want them to share one plan. It works with any agent that can load a skill or an MCP server. Checked so far: jcode (skill and MCP) and Claude Code (MCP).

Install

You need Node 24.11 or newer (Node 26 works) and Git. Linux and macOS.

npm install -g mozak
mozak doctor --fix      # links the mozak skill into ~/.claude/skills, ~/.jcode/skills or ~/.codex/skills if they exist

Shortened. The full README is on GitHub.