引言

我创建这个项目是为了解决一个个人问题：我想直接从Claude代码（以及其他大型语言模型）管理我的Roam Research图。当我构建模型上下文协议（MCP）服务器，让AI代理访问我的笔记时，我意识到底层工具足够强大，可以独立运行。

最初作为AI代理后端的应用，发展成功能齐全的独立CLI。现在，你可以直接从终端使用同样强大的API功能——向Roam传输内容、搜索图表和管理任务——完全不需要大型语言模型。

无论你是想让Claude对你的知识库拥有超能力，还是只是想为自己的脚本建立一个强大的CLI，这个项目都能满足你的需求。

v5.0 新增内容

一行内： roam save 现在每种命名父块的方式都有一个标志，且双方都不会猜测。--parent-uid 始终是 UID;--parent 始终是文本。

直到4.1.0，--parent通过查找区块UID或标题文本来判断。大约五个Roam的UID中有个没有数字，所以这些存档被悄悄误导了。4.1.

Roam Research MCP + CLI

Introduction

I created this project to solve a personal problem: I wanted to manage my Roam Research graph directly from Claude Code (and other LLMs). As I built the Model Context Protocol (MCP) server to give AI agents access to my notes, I realized the underlying tools were powerful enough to stand on their own.

What started as an backend for AI agents evolved into a full-featured Standalone CLI. Now, you can use the same powerful API capabilities directly from your terminal—piping content into Roam, searching your graph, and managing tasks—without needing an LLM at all.

Whether you want to give Claude superpowers over your knowledge base or just want a robust CLI for your own scripts, this project has you covered.

What’s New in v5.0

In one line: roam save now has one flag for each way of naming a parent block, and neither one guesses. --parent-uid is always a UID; --parent is always text.

Until 4.1.0, --parent took either a block UID or heading text and decided which by looking for a digit in the value. About one Roam UID in five has no digit, so those saves were silently misrouted. 4.1.0 added --parent-uid and deprecated passing a UID to --parent. 5.0 finishes the split.

• --parent-uid nests under the block with that UID. It accepts uid or ((uid)), and if no such block exists the command exits non-zero and writes nothing.
• --parent "" nests under the block with that text on the target page, creating it if missing. It is never read as a UID. --parent "((uid))" finds or creates a block whose content is that reference, which was not reliably possible before.