Введение

Я создал этот проект, чтобы решить личную проблему: я хотел управлять графом Roam Research напрямую из Claude Code (и других LLM). Создавая сервер Model Context Protocol (MCP), чтобы агенты ИИ получали доступ к моим заметкам, я понял, что базовые инструменты достаточно мощны, чтобы работать самостоятельно.

То, что начиналось как бэкенд для ИИ-агентов, превратилось в полнофункциональный Автономный CLI. Теперь вы можете использовать те же мощные API напрямую из терминала — передавать контент в роум, искать по графу и управлять задачами — без необходимости в LLM.

Хотите ли вы дать Клоду суперспособности над вашими знаниями или просто хотите развить надёжный CLI для своих собственных сценариев — этот проект вам подойдёт.

Что нового в версии 5.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.