VibeDNA Journal

io.github.marstudio360v1.0.0更新于 Oct 6, 2026

One journal file per project that your AI reads at session start and updates as it works.

已验证STDIO仅桌面Developer ToolsFiles & StorageKnowledge & Memory

概览

AI 生成的概览

为助手提供每个项目一份 Markdown 日志，在会话开始时读取、工作推进时追加，并支持跨全部日志的排序全文搜索。

功能
每个项目对应一个纯 Markdown 日志文件，包含 Current state、Decisions log、Incidents、Handoff for next session 等标准章节。工具可让助手读取整份日志、单个章节或简短交接摘要，追加带时间戳的条目，替换或追加章节，以及新建日志。基于 SQLite FTS5 的索引提供跨全部日志的排序全文搜索与片段，另有最近变更、统计、重叠检查和元数据浏览。可选工具可把规则写入 CLAUDE.md，让这一习惯自动执行。
适用场景
适合助手同时处理多个项目、需要在会话之间延续上下文的场景：决策及其原因、缺陷的根因与修复、当前状态和交接说明。若希望这些记录以纯文件形式保存在本机而非托管服务中，值得添加。
运行要求
以 stdio 运行的本地进程；需要 Python 3.10+ 和 mcp 包。环境变量 JOURNAL_ROOTS（要扫描的文件夹，以分号分隔，默认 ~/Desktop 和 ~/Documents）与 JOURNAL_HOME（索引位置，默认 ~/.journal）。仅限桌面端。可选的市场工具和 rclone 备份需要网络访问，配对时还需要 vibedna.ai 账户令牌。
安装前请注意
日志核心不发起网络请求，日志留在磁盘上，但可选市场工具会访问 vibedna.ai，journal_pair 需要账户令牌；journal_get 可能返回结账链接，因而可能产生购买。journal_install_rule 会写入 CLAUDE.md，journal_backup_to_drive 会把日志复制到 rclone 远端。追加、更新和创建类工具会写入你的日志文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 VibeDNA Journal，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

VibeDNA Journal MCP

One journal file per project that your AI reads at session start and updates as it works.

Journal gives every project one plain markdown file (*_JOURNAL.md). Your AI reads it when a session starts and appends to it as work ships: decisions with their reasons, bugs with root cause and fix, current state, roadmap, and a handoff note for the next session. Ranked full-text search finds an entry across every project's journal at once. One optional tool adds a rule to your CLAUDE.md so Claude Code keeps the habit without being asked.

  • Runs locally over stdio. Python 3.10+ and the mcp package.
  • The journaling core makes no network calls. Your journals stay on your disk.
  • Optional marketplace tools browse and download journals from vibedna.ai, only when you call them.

Homepage: https://vibedna.ai/store/journal

Tools (25)

Catch up on a project

ToolWhat it does
journal_handoff_brief(name)Short catch-up: header plus the latest entries
journal_read(name, max_kb)Full journal contents
journal_read_section(name, section)One section, e.g. Current state or Handoff for next session
journal_list_sections(name)The H2 sections of a journal
journal_list(project, last_days)List the journals in the index

Log work as it ships

ToolWhat it does
journal_append(name, entry, tag)Timestamped entry
journal_update_section(name, section, new_content, mode)Replace, append or prepend a section
journal_create(name, project_dir, body)New journal with the standard sections

Search

ToolWhat it does
journal_search(query, project)Ranked full-text search (SQLite FTS5) across all journals, with snippets
journal_recent_changes(last_hours)Journals updated lately
journal_stats()Totals, biggest and freshest journals
journal_browse(domain, tier, kind, tag)Browse the local library by metadata
journal_market_index(kind)Local feed of journals of one kind, with metadata
journal_overlap_check(name)Find journals that overlap with this one

Setup

ToolWhat it does
journal_index_refresh()Rescan the roots for journal files
journal_config_add_root(path)Add a folder to scan
journal_get_claude_rule()The recommended CLAUDE.md rule text
journal_install_rule(scope, confirm)Install that rule (preview unless confirm=True)
journal_backup_to_drive(name, remote, remote_folder)Copy journals to your own rclone remote (optional)
check_for_update()Compare this copy with the published version
vibedna_info()Product metadata

Marketplace (optional, reaches vibedna.ai)

ToolWhat it does
journal_market(query, domain)Browse the VibeDNA journal shelf
journal_pair(token)Link this install to a vibedna.ai account
journal_get(slug)Download a journal you own, or get a checkout link for one you don't
journal_library()List the journals you own

Install

bash
git clone https://github.com/marstudio360/vibedna-journal-mcpcd vibedna-journal-mcppip install -r requirements.txt

JOURNAL_ROOTS is the list of folders to scan for journal files, separated by ;. Without it, Journal scans ~/Desktop and ~/Documents.

Claude Code

bash
claude mcp add journal --scope user -e JOURNAL_ROOTS="/path/to/your/projects" -- python /absolute/path/to/vibedna-journal-mcp/server.py

Or in a project's .mcp.json:

json
{  "mcpServers": {    "journal": {      "command": "python",      "args": ["/absolute/path/to/vibedna-journal-mcp/server.py"],      "env": { "JOURNAL_ROOTS": "/path/to/your/projects" }    }  }}

Then ask Claude: "Install the journal CLAUDE.md rule globally." That is the step that makes it read and write the journals on its own.

Cursor

Add the same mcpServers block to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).

Claude Desktop

Add the same mcpServers block to claude_desktop_config.json (Settings > Developer > Edit Config), then restart Claude Desktop.

INSTALL.md is a step-by-step guide written so you can paste it into an AI chat and let the AI do the install.

Configuration

VariableDefaultWhat it does
JOURNAL_ROOTS~/Desktop;~/DocumentsFolders to scan for *JOURNAL*.md files
JOURNAL_HOME~/.journalWhere the search index and optional config live
JOURNAL_TRANSPORTstdiohttp serves streamable HTTP on PORT, for cloud hosting only

Journal scaffold

journal_create starts every journal with these sections:

## Vision / Why this exists## Current state## Roadmap## Decisions log## Incidents## Handoff for next session## Recent entries

Security

See SECURITY.md for what the server reads, writes and sends.

License

MIT, see LICENSE. Copyright (c) 2026 VibeDNA.

Support: [email protected]

来源：README.md，提交 c955a74

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Oct 6, 2026