Skip to content
MCP server

VibeDNA Journal

One markdown journal per project that your AI must read before it edits or runs anything

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, Windows, macOS
Runs
Locally
Version
1.0.3
Listing updated
1 day ago

About VibeDNA Journal

VibeDNA Journal is a free MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

The idea is that an assistant already has notes, but nothing makes it read the right one at the moment it acts. Journals DNA keeps a plain markdown journal per project of what shipped, what broke and what was decided, and in Claude Code a mod hands the relevant journal brief to the AI on its first touch of a file or command. Codex, GitHub Copilot and Cursor have beta adapters that deliver the same brief; in other apps the AI gets the journals but must choose to read them.

Several safeguards ride along. When a later entry changes a decision or price, the older one is shown with the newer entry beside it. A default rules pack stops once on a secret written to a file, a delete that wipes a folder, losing unsaved git work, DROP or DELETE without WHERE, a force push to main and overwriting .env files, and waits for a yes before publishing, spending or messaging customers. Status lines such as active or paused are flagged to be checked live.

Everything is files on your disk, so nothing is stored on the vendor's side and no account is needed. A local search index finds entries by meaning across projects, and journals can be opened in Obsidian. It does not write code; it keeps the reasons behind it.

Install

Run in a terminal

claude mcp add vibedna-journal-mcp -- npx -y https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vibedna-journal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vibedna-journal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "vibedna-journal-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "vibedna-journal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "vibedna-journal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb"
      ]
    }
  }
}

Configuration

  • JOURNAL_ROOTSFolders to scan for *JOURNAL.md files, separated by ;
  • JOURNAL_HOMEWhere the local search index lives. Default ~/.journal

What it does

Journal before action
The mod puts the relevant journal in front of the AI before it edits or runs a command.
Newest word wins
Outdated decisions and prices are shown next to the newer entry.
Default safety rules
Stops once on leaked secrets, wiping deletes, force pushes and similar.
Approval gates
Publishing, spending and messaging customers wait for a yes.
Cross-project search
A local model finds entries by meaning, even in another language.
Plain files
Journals are markdown on your disk and open in Obsidian.

Good for

  • Resume a project after a long break with the decisions intact
  • Stop an agent repeating a fix you already rejected
  • Hand work to another AI or teammate by sending the journal
  • Guard against destructive commands in an AI session

Pricing

Free

Free tool; paid memberships cover other Vibedna products

Prices change. Check vibedna.ai before you buy.

VibeDNA Journal FAQ

Does it need an account?

No. The site says it is files on your disk, not a service.

Which AI apps get the full mod?

Claude Code; Codex, Cursor and GitHub Copilot have beta adapters.

What happens in other apps?

The AI gets the journals but must choose to read them.

Is it free?

The pricing page lists Journals DNA among the free tools.

Is VibeDNA Journal free?

Yes. VibeDNA Journal is free to use.

How do I add VibeDNA Journal to Claude Code?

Run this command in your terminal: claude mcp add vibedna-journal-mcp -- npx -y https://github.com/marstudio360/vibedna-journal-mcp/releases/download/v1.0.3/vibedna-journal-mcp-1.0.3.mcpb

What are the best alternatives to VibeDNA Journal?

The closest alternatives to VibeDNA Journal are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to VibeDNA Journal

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools