roamresearch

Automate Roam Research read, write, and query workflows via roam-cli.

1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/Leechael/roam-cli --skill roamresearch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roamresearch
Source: https://github.com/Leechael/roam-cli/tree/main/skills/roamresearch
Command: npx skills add https://github.com/Leechael/roam-cli --skill roamresearch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Roam users need a seamless way to read, search, and modify content in Roam graphs without leaving the command line. This skill provides a structured interface to perform common Roam operations through the roam-cli tool, enabling faster workflows and reproducible results.

Core Features & Use Cases

  • Read pages and blocks by title or UID
  • Search blocks and pages with datalog-like queries
  • Save Markdown as Roam pages or daily notes, with optional sectioning and parent-child relationships
  • Execute low-level block and batch writes with environment-authenticated access

Quick Start

Install roam-cli and run a simple get command to retrieve a page.

Frequently Asked Questions about roamresearch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Roam Research blocks and pages from the command line?

Search Roam Research blocks and pages using datalog queries executed through the roam-cli tool. This skill automates query workflows to retrieve specific content directly from your Roam graph without manual web interface interaction.

Can I save markdown files as Roam Research pages or daily notes?

Save markdown content as Roam Research pages or daily journal entries using this skill. It structures the markdown input with optional sectioning and parent-child block relationships during the write operation.

Do I need an API token to use roam-cli for block retrieval?

Using roam-cli for block retrieval requires a ROAM_API_TOKEN and a ROAM_API_GRAPH environment variable configured. You must also install the roam-cli tool and ensure it is available in your system PATH.

What is the best way to automate read and write workflows for Roam Research?

Automate Roam Research read and write workflows by executing low-level block operations and batch writes through the command line. This approach provides environment-authenticated access for reproducible graph modifications.

How do I retrieve a specific Roam Research page by title or UID?

Retrieve specific Roam Research pages by supplying the title or UID to the get command. This skill automates the page and block retrieval process using the configured roam-cli environment.

Are there limitations to executing datalog queries for Roam Research?

Datalog queries are limited by the roam-cli tool capabilities and your API token permissions. This skill handles search and retrieval operations but requires proper environment variables to function correctly.