# mozak

Keeps a single approved plan per project in plain files, so several coding agents read the same plan instead of overwriting each other.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: pitfa19
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pitfa19/mozak
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/mozak

## What it does

The plan lives in two files: `mozak.json` for the data and `mozak.md` as a readable copy. They sit beside your `README.md`, and git tracks the history if the folder is a repo. No cloud, no account, no daemon.

Agents that load the skill or the MCP server begin from that same plan, so you stop pasting context into each one. An agent can suggest edits, yet nothing counts as the plan until you approve it. Agreeing on what to build and agreeing to start are separate approvals. A write coming from a stale copy is refused rather than allowed to clobber someone else's work.

Node 24.11 or newer and Git are required, on Linux or macOS. You list projects in `mozak-inventory.json`: a local folder, a folder inside an Obsidian vault, or a GitHub repo. For a private repo the plans stay inside it and everyone with access shares them. For a public repo add `"plans"` pointing at a folder, usually in your notes — otherwise the plans would be committed to the repo.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mozak -- npx -y mozak
```

### Codex

**Platform CLI**
```bash
codex mcp add mozak -- npx -y mozak
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mozak": {
            "command": "npx",
            "args": [
                "-y",
                "mozak"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mozak": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mozak"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mozak npx -y mozak
```

## When to use it
- point several agents at one project plan
- stop agents from overwriting each other's edits
- watch parallel work from Obsidian
- keep a project plan in git without a cloud account
- keep plans for a public repo private

## Example prompts
- Show the current plan for this project and what is already done
- Propose the next step and wait for my approval
- Record the test run result in the plan

## Similar
- [llm-wiki](https://affpapa.org/en/nevibecode/skills/ar9av-llm-wiki.md) — skill · 4100 installs
- [wiki-query](https://affpapa.org/en/nevibecode/skills/wiki-query.md) — skill · 3600 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [second-brain](https://affpapa.org/en/nevibecode/skills/second-brain.md) — skill · 2800 installs
- [obsidian-canvas-creator](https://affpapa.org/en/nevibecode/skills/obsidian-canvas-creator.md) — skill · 2000 installs
- [my-brain-is-full-crew](https://affpapa.org/en/nevibecode/skills/my-brain-is-full-crew.md) — skill · 1100 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