서론

이 프로젝트를 만든 이유는 개인적인 문제를 해결하기 위해서였습니다: 저는 Roam Research 그래프를 Claude 코드(및 기타 LLM)에서 직접 관리하고 싶었습니다. AI 에이전트가 제 노트에 접근할 수 있도록 모델 컨텍스트 프로토콜(MCP) 서버를 구축하면서, 기본 도구들이 독립적으로 충분히 강력하다는 것을 깨달았습니다.

AI 에이전트의 백엔드로 시작된 것이 완전한 기능을 갖춘 독립형 CLI로 진화했습니다. 이제는 LLM 없이도 단말기에서 직접 강력한 API 기능을 사용할 수 있습니다—Roam에 콘텐츠를 전송하고, 그래프를 검색하며, 작업 관리를 할 수 있습니다.

Claude에게 지식 기반에 대한 강력한 권한을 주고 싶든, 단지 자신의 스크립트에 대한 강력한 CLI를 원하든, 이 프로젝트가 여러분을 만족시켜 드립니다.

v5.0의 새로운 소식

한 줄에서: roam save는 이제 부모 블록 명명법마다 하나의 플래그를 가지며, 둘 다 추측하지 않습니다. --parent-uid는 항상 UID입니다; --parent는 항상 텍스트입니다.

4.1.0 이전까지는 --parent가 블록 UID나 제목 텍스트를 받아 값 중 숫자를 찾아 어떤 것을 선택했는지 결정했습니다. Roam UID의 5명 중 1명은 숫자가 없어서 그 저장 파일들이 조용히 잘못 전달된 것입니다. 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.