# Change Log ### [Updating Roam]([[Updating Roam]]) ### **New Changes** - [[July 2nd, 2026]] - [[Quality of Life Improvements]] - Added copy blocks and delete blocks to the single block multi select menu - Added saving code block folds - [[Bug Fixes]] - Fixed export page to respect filters - Fixed copy to respect filters - [[June 30th, 2026]] - [[Roam Depot Extensions]] - **Roam Alias Finder** - Find the places you __meant__ to link but never did. Alias Finder scans your graph for plain‑text mentions of a page's existing aliases and lets you turn each one into a proper link with a single click. No alias list to maintain, no setup. - ![Alias Finder grouping unlinked alias mentions below a page's references, each with a one-click Link button](https://raw.githubusercontent.com/wireframe/roam-alias-finder/main/screenshots/screenshot.png)[🔗](https://raw.githubusercontent.com/wireframe/roam-alias-finder/main/screenshots/screenshot.png) - **Why** - Roam aliases let you write `[slip-box]([[Zettelkasten]])` so natural prose still links to the right page. But once you've used an alias a few times, older notes are full of the same words sitting as plain text, invisible to backlinks. Finding and fixing them by hand is tedious. - Alias Finder learns the aliases you already use for a page and surfaces every unlinked mention across the graph, so you can wire them up in seconds. - **What it does** - A Find unlinked aliases button appears at the bottom of every real page, right below Roam's Unlinked References section. It only shows on real pages — never on daily notes. - Click it and Alias Finder: - Reads the page's existing aliases — every `[text]([[ThisPage]])` already in your graph — and uses that text as the search terms. Nothing to configure. - Scans the whole graph for unlinked, plain‑text occurrences of those terms. - Groups the results by alias under collapsible, alphabetically‑sorted headers with a match count, and highlights the matched text in each block. - Lets you link any match with one click — it wraps the text as `[text]([[ThisPage]])`, preserving your original casing, and removes the row. - **Match rules** - Matching is deliberately careful, because it writes to your graph: - Whole words only — `OKRS` never matches inside `weorks`. - Case‑insensitive — `Zettel` and `zettel` both match the alias `zettel`; your original casing is kept when linking. - Skips text that's already linked — occurrences inside `[[page links]]`, `((block refs))`, `#tags`, and existing `[alias]([[page]])` links are ignored. - Skips URLs — matches inside `http(s)://…` and `www.…` are ignored. - Skips noise — single‑character aliases (`*`) and footnote‑style numbers (`1`, `2`, …) are never used as search terms. - [[June 13th, 2026]] - [[Roam Depot Extensions]] - **🎧 Audio Feedback — Roam Research Extension** - Adds subtle, synthesized audio cues to your Roam workflow. Every block action — checking a TODO, collapsing a branch, navigating to a new page — gets a sound that confirms the action without interrupting your flow. - > 🚀 Zero Dependencies: Built entirely on the native browser Web Audio API. No external libraries, no bloated bundles. Sounds are generated mathematically on the fly. - **Demo** - **Themes** - Select your theme in Settings → Extensions → Audio Feedback → Sound Theme. - {{[[table]]}} - Theme - Character - 🌿 Zen - Soft sine tones that dissolve as quickly as they appear. Designed to confirm without interrupting. - 👾 Retro - Square-wave pulses with Game Boy-era frequencies. Every action lands with a satisfying, deliberate click. - 💫 Halo - Layered FM bells with a floating upper harmonic. - 🎛 Custom - Your sounds, your rules. Upload any audio file to your Roam graph and paste the Firebase URL to replace any event sound. - **Events** - {{[[table]]}} - Event - Trigger - TODO Done - Checking a TODO checkbox → DONE - Collapse - Collapsing a block that has children - Expand - Expanding a block that has children - Indent - Indenting a block (Tab) - Outdent - Outdenting a block (Shift+Tab) - Navigate - Zooming into a block or changing page - Sidebar Open - Opening a new item in the right sidebar - **Settings Reference** - {{[[table]]}} - Setting - Description - Default - Enable Audio Feedback - Master on/off switch - On - Master Volume - 0.0 to 1.0 - 0.4 - Sound Theme - Zen · Retro · Halo · Custom - Zen - TODO Sounds - Toggle checkbox event sounds - On - Navigation Sounds - Toggle zoom and sidebar sounds - On - Hierarchy Sounds - Toggle collapse, expand, indent, outdent sounds - On - **Command Palette** - Three commands are available via `Cmd+P` (or `Ctrl+P`): - Audio Feedback: Toggle On/Off — master switch without opening settings - Audio Feedback: Volume Up — increases master volume by 0.1 - Audio Feedback: Volume Down — decreases master volume by 0.1 - Audio Feedback: Next Theme — cycles Zen → Retro → Halo → Zen (Custom is excluded from cycling; select it manually in settings) - **Custom Sounds** - Custom theme lets you replace any event sound with your own audio file. - **How to upload a sound to your Roam graph** - Open any page in Roam - Type `/Upload file` and select your `.wav` or `.mp3` - Once uploaded, right-click the file attachment → Copy link - The URL will look like: `https://firebasestorage.googleapis.com/...` - Paste that full URL into the corresponding field in Settings → Audio Feedback → CUSTOM SOUND URLs - Switch theme to Custom - **Notes on Custom playback** - First play has a brief load delay — the extension fetches and decodes the audio file on first use. Every subsequent play of the same URL is instantaneous (the buffer is cached for the session). - Blank URL = silence — if a URL field is empty, that event produces no sound. This is intentional. You can mix custom sounds for some events and silence for others. - URL must include the `?alt=media&token=...` suffix — without it, Firebase returns a redirect rather than the raw audio file and playback will fail silently. - Test URL (courtesy of Adam Krivka): `https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2FMyelin%2F-J1q4HZsEl.wav?alt=media&token=34ab3de0-1b43-4361-8c7e-141c1925011b` - **Physics Bridge** - All three synthesized themes (Zen, Retro, Halo) are aware of your block's position in the hierarchy. Sounds shift subtly based on: - Depth — how many levels deep the block is nested. Deeper blocks produce slightly higher pitched, shorter sounds. - Mass — how many children the block has. Heavier blocks produce slightly lower pitched, longer sounds. - This means the same action sounds meaningfully different depending on where it occurs in your outline — without ever being distracting. - [[June 11th, 2026]] - [[Bug Fixes]] - Fixed a bug where desktop links for offline and hosted graphs with the same name would not open a new window if the other was open, as in `roam://#/app/graph` and `roam://#/offline/graph` - Added a new section to our privacy policy to be in compliance for our soon to be released remote MCP - [[June 10th, 2026]] - [[Bug Fixes]] - Fixed search result highlighting to prioritize matching full phrases and to handle accented characters - [[June 9th, 2026]] - [[Bug Fixes]] - Fixed large pastes and deletes causing thousands of unsynced changes - Pasting tons attributes can still cause this but that will be fixed soon as well - [[June 2nd, 2026]] - [[Roam Depot Extensions]] - **Oura Ring to Roam** - Roam Depot extension that syncs Oura Ring data into a Roam graph as editable, queryable blocks with compact visual summaries. - **What It Does** - Syncs Sleep, Readiness, Activity, Vitals, My Health, Workouts, and Tags from the Oura API. - Stores canonical history under a configurable `[[Oura Ring]]` page, one Roam day root per Oura day. - Adds existing Daily Notes embeds for each day's `Daily summary` block without creating missing Daily Notes. - Renders disposable visual components over Roam source blocks: daily sleep-first cards, hypnograms, contributor bars, HR/HRV trends, activity load, temperature, oxygen, stress, and weekly review. - Keeps headline metrics queryable as Roam attributes such as `Sleep Score::`, `In bed at::`, `Out of bed at::`, `Readiness Score::`, `Activity Score::`, `HRV::`, `Resting HR::`, and `Steps::`. - **Setup** - Generate an Oura Personal Access Token at https://cloud.ouraring.com/personal-access-tokens. - In Roam, open Roam Depot -> Extension Settings -> Oura Ring. - Paste the token and choose your sync/backfill settings. - Run Oura: Sync now from the command palette. - The token is stored in Roam's extension settings for this graph. It is sent only to Oura through Roam's native CORS proxy when syncing. - **Commands** - Oura: Sync now fetches the configured window and reconciles the Oura page. - Oura: Open Oura page opens the canonical store page. - Slash commands: `/oura today`, `/oura yesterday`, `/oura sleep`, and `/oura callout`. - [[June 1st, 2026]] - [[Bug Fixes]] #PDF - Fixed merging PDF pages into other non PDF pages - Fixed displaying annotations on rotated PDFs - Fixed double clicking to select a word, or triple clicking to select an entire line for most PDFs, although some may still have trouble - [[May 28th, 2026]] - Add back the nav bar find or create, with some of the UI improvements from the modal redesign - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FxCeKIxA4sd.png?alt=media&token=e1fa5076-a8c9-440a-9bff-717bb080b783) - The modal can still be triggered via the button to open advanced search on the right, or `ctrl-o` to open the preview - Or you can set a custom hotkey for "Open advanced search" and override the default cmd-u which focuses the navbar search. - [[May 21st, 2026]] - [[Quality of Life Improvements]] - Redesigned the find or create [[Search]] (`cmd/ctrl-u`) - Page results now show reference counts - Block results now include paths, improved truncation, and clearer match highlighting - Added a preview window that can be toggled with `ctrl-o` - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FcDSpdGkLLo.gif?alt=media&token=a86d177f-341c-4f81-8dfb-cd43e3cd979c) - [[May 15th, 2026]] - [[Quality of Life Improvements]] - Inline page search `[[]]` now sorts the exact match to the top - Makes a difference when you have two pages with the same case - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FNYA0VeVtyF.png?alt=media&token=27f0fb60-99cd-4898-a625-4fababcf2b7f) - Inline block search `(())` can now search for UIDs if it's an exact match `((yPgg9DUbF))` - [[Bug Fixes]] - Fix paste from chatGPT adding extra newlines in bulleted lists - [[May 5th, 2026]] - [[Quality of Life Improvements]] - Added a sort option for `{{table}}` - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FYS5YpnZLN1.png?alt=media&token=e573ac8b-1b54-4a39-9f2f-1f9bd4469d60) - Improved drag-and-drop behavior: when dragging an item near the edge of a scrollable container, Roam now automatically scrolls the container so you can continue moving the item without interruption. - [[Roam Depot Extensions]] - **History of Today** - A lightweight Roam Research extension that adds "On this day" buttons at the bottom of the calendar popover. Click a year button to instantly jump to that year's daily notes page. - ![Screenshot of the extension in action](https://raw.githubusercontent.com/laixintao/roam-research-history-of-today/main/pics/history-of-today.png)[🔗](https://raw.githubusercontent.com/laixintao/roam-research-history-of-today/main/pics/history-of-today.png) - **Features** - Shows up to 5 previous years at the bottom of the calendar - Only displays years that already have a daily notes page — no clutter from empty years - Buttons show the 2-digit year (e.g. `'25`, `'24`) with a full date tooltip on hover - Automatically re-injects when the calendar popover is opened - [[May 4th, 2026]] - [[Roam Depot Extensions]] - **Roam Meta Type** - Typed pages for Roam Research. Add a `Type::` attribute to a page and a chip appears next to the title; click it to open a sidebar panel with the fields you care about for that type. - **Encouraging Structure for Your Second Brain** - Roam's freedom as an outline is the whole point. But the people, projects, books, and articles I keep coming back to all have __some__ structure: an email, a status, a due date, an author. Today that structure is invisible — you have to read the page to learn what kind of thing it is, and scan the outline to find the fields that matter. - `roam-meta-type` keeps the outline. It just makes the structure visible. - **What it does** - Unobtrusive pill-shaped chip page identification based on supported `Type::` attribute. Multi-typed pages (`Type:: #Project #Blog`) get one chip per type. - Click a chip → a panel mounts at the top of Roam's right sidebar with that type's pinned fields, rendered as label/value rows. ![Sidebar panel for a Project](https://github.com/wireframe/roam-meta-type/raw/main/screenshots/panel-project.png)[🔗](https://github.com/wireframe/roam-meta-type/blob/main/screenshots/panel-project.png) - Sidepanel is an integrated inline-editor. Click any row → it flips to inline edit mode using Roam's own block editor (autocomplete, page-refs, formatting — all of it). Click any value to flip the row into Roam's block editor. Empty rows render as `—`. Click and the plugin creates the missing block (e.g. `Status:: `) before flipping into edit mode. ![Inline editing a row](https://github.com/wireframe/roam-meta-type/raw/main/screenshots/inline-edit.png)[🔗](https://github.com/wireframe/roam-meta-type/blob/main/screenshots/inline-edit.png) - Sidepanel reactively refreshes to updates live: edit `Priority::` directly in the page body, the panel updates without a re-render. - Configurable types, fields, and accent colors via the Roam settings panel (no source edits required). - **Configuring types** - The extension ships with no default types. Open Settings → Meta Type to add your first one. - The settings tab shows a vertical stack of cards, one per configured type. Each card has: - Name — the type name. Must match the page-ref in `Type::` blocks (e.g., `Project`). - Hue and Saturation — HSL components for the chip's accent color (hue 0–360, saturation 0–100; lightness is computed). A small swatch preview updates as you type. - Fields — comma-separated list of field names (e.g., `Status, Priority, Due, Topics`). Each becomes a row in the sidebar panel. - A trash button on the right to remove the card. - Below the cards are Add type (appends a blank card) and Save. Click Save to persist; the extension closes any open panels and re-renders chips with the new config. - Two settings are not exposed in the UI and remain at their defaults: - `typePrefix` — the block prefix used to detect typed pages (default `Type::`). - `flashColor` — the RGB highlight color for the click-flash animation (default `{ r: 16, g: 107, b: 163 }`). - These are stored in the same JSON value as the types and preserved on every save. Power users who need to change them can edit the underlying setting key directly via Roam's developer tools (key: `types-config` under this extension's settings). - If the stored JSON is missing or malformed (e.g., from a manual edit gone wrong), the extension falls back to the empty defaults and logs a warning to the browser console. - **How a page gets typed** - Add a `Type::` attribute as a top-level block on the page, with one or more `#TypeName` references: - ```plain text - Type:: #Project - Status:: Doing - Priority:: P1 - Due:: [[April 30th, 2026]] - Topics:: [[Roam]] [[Productivity]]``` - The plugin reads `Type::`, looks each reference up in the configured types, and renders one chip per known type. Unknown types are silently skipped — no chip, no error. - [[May 1st, 2026]] - New version of the **Roam [[Raycast]] extension** is out! -  {{[[video]]: https://www.loom.com/share/998c8bce7ebd4827b3c9e8aec1278621}} - Do watch the video to understand, but main improvements: - Better Quick Capture - you can have templates for capture now and also have a very quick way of capture that I’m calling “instant capture” - Uses the Append API so you can have “capture groups” inside of pages and can also capture to encrypted graphs - Better UI IMO where you enter the capture text first and only then select where you want to send it - Windows support (raycast now supports windows) - Better text and error messages across the extension - Since this version is the first one that adds windows support, would particularly appreciate if Windows users put it through the paces and let us know of any bugs or issues - [[April 27th, 2026]] - [[Roam Depot Extensions]] - **Roam Toolkit Vim Mode** - Standalone Vim-like navigation and editing for Roam Research, extracted from the original Roam Toolkit browser extension. - ![Roam Toolkit Vim Mode demo](https://raw.githubusercontent.com/Stvad/roam-vim-navigation/master/media/vim_demo.gif)[🔗](https://raw.githubusercontent.com/Stvad/roam-vim-navigation/master/media/vim_demo.gif) - This README summarizes the current functionality, but the authoritative up-to-date shortcut list is in Roam under `Settings -> Extensions -> Roam Toolkit Vim Mode`, where every binding is editable. - **Current Functionality** - Normal, insert, and visual-mode style workflows for Roam blocks - Vim-like navigation within the current panel and across sidebars - Selection, clipboard, block movement, history, hinting, and Roam-specific editing helpers - Normal-mode `Tab` / `Shift+Tab` shortcuts for Roam-style indenting and outdenting - **Default Keybindings** - Default layout preset is `qwerty`. The Roam settings panel remains the authoritative live list, because every shortcut can be remapped there. - If you switch `Keyboard Layout` to `colemak`, these defaults change: - {{[[table]]}} - Action - QWERTY - Colemak - Select Block Up - `k` - `h` - Select Block Down - `j` - `k` - Select Panel Left - `h` - `j` - Move Block Up - `Cmd+Shift+K` - `Cmd+Shift+H` - Move Block Down - `Cmd+Shift+J` - `Cmd+Shift+K` - Increment Date (layout up key) - `Ctrl+Alt+K` - `Ctrl+Alt+H` - Decrement Date (layout down key) - `Ctrl+Alt+J` - `Ctrl+Alt+K` - Increment Date by a week (layout up key) - `Ctrl+Shift+K` - `Ctrl+Shift+H` - Decrement Date by a week (layout down key) - `Ctrl+Shift+J` - `Ctrl+Shift+K` - Page-hint labels also switch to a Colemak-friendly alphabet when that layout preset is selected. - **Navigation and Panels** - {{[[table]]}} - Mode - Keys - Action - Normal + Visual - `k` - Select block up - Normal + Visual - `j` - Select block down - Normal - `Shift+H` - Select first visible block - Normal - `Shift+L` - Select last visible block - Normal - `g g` - Select first block - Normal - `Shift+G` - Select last block - Normal - `Ctrl+U` - Jump up by several blocks - Normal - `Ctrl+D` - Jump down by several blocks - Normal + Visual - `Ctrl+Y` - Scroll up while keeping selection visible - Normal + Visual - `Ctrl+E` - Scroll down while keeping selection visible - Normal + Insert - `Alt+Z` - Expand last reference breadcrumb - Normal - `Shift+Z` - Collapse the current page view inside references or query results - Normal - `1` - Open parent page - Normal - `Shift+1` - Open parent page in sidebar - Normal - `2` - Open mentions - Normal - `Shift+2` - Open mentions in sidebar - Normal - `z` - Toggle fold block - Normal - `Ctrl+Shift+Z` - Collapse into parent block - Normal - `h` - Select panel left - Normal - `l` - Select panel right - All - `Ctrl+W` - Close current sidebar page - **Editing, Selection, and Clipboard** - {{[[table]]}} - Mode - Keys - Action - All - `Escape` - Return to normal mode - Normal - `i` - Edit selected block at start of line - Normal - `a` - Edit selected block at end of line - Normal - `Shift+A` - Edit selected block at end of line - Normal - `Shift+O` - Insert block before current block - Normal - `o` - Insert block after current block - Normal - `Tab` - Indent current block under the previous sibling - Normal - `Shift+Tab` - Outdent current block to the parent level - Normal - `v` - Enter visual mode - Normal + Visual - `Shift+K` - Grow selection upward - Normal + Visual - `Shift+J` - Grow selection downward - Normal - `p` - Paste below current block - Normal - `Shift+P` - Paste before current block - Normal + Visual - `y` - Copy selected block or selection - Normal + Visual - `Alt+Y` - Copy block reference - Normal + Visual - `Shift+Y` - Copy block embed - Normal + Visual - `d` - Enter visual mode, or cut current visual selection - Normal + Insert - `Cmd+Shift+K` - Move current block up - Normal + Insert - `Cmd+Shift+J` - Move current block down - Normal - `u` - Undo - Normal - `Ctrl+R` - Redo - **Hints** - {{[[table]]}} - Mode - Keys - Action - Normal - `q`, `w`, `e`, `r`, `t`, `f`, `b` - Click inline hint targets `0` through `6` inside the selected block - Normal - `Shift+q`, `Shift+w`, `Shift+e`, `Shift+r`, `Shift+t`, `Shift+f`, `Shift+b` - Shift-click inline hint targets `0` through `6` - Normal - `Ctrl+Shift+q`, `Ctrl+Shift+w`, `Ctrl+Shift+e`, `Ctrl+Shift+r`, `Ctrl+Shift+t`, `Ctrl+Shift+f`, `Ctrl+Shift+b` - Modifier-click inline hint targets `0` through `6` - Normal - `s` - Start page-wide hint mode for visible blocks only - Normal - `Shift+S` - Start page-wide hint mode for visible blocks and links - Normal - `g l` - Start page-wide hint mode for visible links only - Normal - `Shift+I` - Start page-wide hint mode for visible blocks and enter insert mode - **Roam-Specific Helpers** - {{[[table]]}} - Mode - Keys - Action - Normal - `Cmd+Enter` - Toggle `TODO` / `DONE` - Normal - `Ctrl+Shift+1` - Reschedule current SRS note as `AGAIN` - Normal - `Ctrl+Shift+2` - Reschedule current SRS note as `HARD` - Normal - `Ctrl+Shift+3` - Reschedule current SRS note as `GOOD` - Normal - `Ctrl+Shift+4` - Reschedule current SRS note as `EASY` - Normal - `Ctrl+Alt+Up` - Increment the only date reference in the block by one day - Normal - `Ctrl+Alt+Down` - Decrement the only date reference in the block by one day - Normal - `Ctrl+Alt+K` - Increment the only date reference in the block by one day using the layout up key - Normal - `Ctrl+Alt+J` - Decrement the only date reference in the block by one day using the layout down key - Normal - `Ctrl+Shift+Up` - Increment the only date reference in the block by one week - Normal - `Ctrl+Shift+Down` - Decrement the only date reference in the block by one week - Normal - `Ctrl+Shift+K` - Increment the only date reference in the block by one week using the layout up key - Normal - `Ctrl+Shift+J` - Decrement the only date reference in the block by one week using the layout down key - **Settings Model** - `Keyboard Layout` switches layout-sensitive defaults between `qwerty` and `colemak` - layout-sensitive bindings update from that preset, and page-hint labels follow the selected alphabet - if the browser exposes keyboard layout change events, the plugin re-registers hotkeys automatically when the system layout changes - shortcuts are grouped by mode in the Roam settings panel, and each binding can be customized there - `Reset Shortcuts` restores the default keymap for the selected layout - **Attribution** - Most of the original Vim functionality in Roam Toolkit was developed by Dave Lu (@tntmarket on GitHub). - [[April 17th, 2026]] - [[mobile]] - Added font size control - Native view now follows settings from the web app for page brackets and namespaces - Fix native view search keyboard not enabling swipe with Gboard - Tables show heading cols/rows and respect column sizing from `/table` Improvements - [[April 15th, 2026]] - [[Quality of Life Improvements]] - `/table` Improvements - [[table]] is now interactive! - You can click into cells, edit content, copy and paste, and move blocks around inside a table. - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FW2QvreU_jY.gif?alt=media&token=165ca591-a825-4762-b95f-65abb8532c12) - [[April 14th, 2026]] - [[Roam Depot Extensions]] - **꩜ Nautilus Enhanced** - [English](https://github.com/hopeserena/nautilus-enhanced/tree/main#english) | [中文](https://github.com/hopeserena/nautilus-enhanced/tree/main#%E4%B8%AD%E6%96%87) - **English** - Nautilus Enhanced is an optimized, high-performance daily planner extension for Roam Research, inspired by the original Nautilus created by Tomas Barys. - **Acknowledgements** - This project is an enhanced fork of the original [roam-depot-nautilus](https://github.com/tombarys/roam-depot-nautilus) repository. A huge thank you to the original author, Tomas Barys, for his brilliant concept of using a spiral timeline to visualize energy and tasks throughout the day! This __Enhanced__ version introduces deep performance optimizations (eliminating memory leaks), fully localized bilingual Settings, Bezier curve typography connectors, and visual UI/UX spacing fixes. - **Quick Start Guide** - One-time Setup: - Install Nautilus Enhanced. - (Optional but Recommended) Install [Todo Trigger](https://github.com/dvargas92495/roamjs-todo-trigger) from Roam Depot to automatically append timestamps to completed tasks. - Configure your preferences (workday start time, colors, lengths) in the Settings panel. - Daily Routine: - Type `;;` and select `Nautilus Enhanced` to insert the spiral component into today's Daily Note. - Indent your tasks and meetings strictly underneath the component block. - Events (Fixed time): Add a time range anywhere in the text (e.g., `12:30-14:00 Lunch`). - Tasks (Flexible): Write your regular to-dos (e.g., `Read a book 30m`). If no time is set, they fall into the default setup. - Watch the red pointer act as your dynamic clock, pushing unfinished, un-timed tasks forward into the future as the day goes on! - **中文 (Chinese)** - Nautilus Enhanced（鹦鹉螺行程图增强版） 是为 Roam Research 专门优化的每日行程与精力可视化插件。 - **致谢与鸣谢** - 本项目基于 Tomas Barys 开发的原生开源项目 [roam-depot-nautilus](https://github.com/tombarys/roam-depot-nautilus) 进行了深度重构与增强。非常感谢原作者卓越的设计理念（使用螺旋形状映射人在一天中不断衰减的精力曲线）。本“增强版”解决了原版的由于计时器导致的严重内存泄露问题，重新设计了具备原生中英双语的设置面板，优化了连接线的贝塞尔曲线动画以及汉字的精准排版，让它真正成为了一个高可用、高颜值的生产力工具。 - **极简使用教程** - 首次配置（只需做一次）： - 安装本插件。 - （建议配合使用）在 Roam 商店中安装 [Todo Trigger](https://github.com/dvargas92495/roamjs-todo-trigger) 插件，以实现当你勾选 TODO 为 DONE 时，系统能自动在句尾打上完成时间戳。 - 在插件设置页中，按你的习惯配置“工作开始时间”、“高亮触发词”、“默认时长”等内容。 - 日常使用工作流： - 每天在你的 Daily Note（每日笔记） 页面通过输入 `;;` 唤出模板菜单，选择 `Nautilus Enhanced` 组件。 - 在渲染出的组件下方缩进一级作为子块（Children Block），把你今天想做的事情全部列出来。 - 固定日程：在你记录的事项文字任何一处输入时间段（如：`12:30-14:00 午餐会议`），它就会被固定分配在表盘特定时段上。 - 弹性待办：直接记录没有写绝对时间的待办事项（如：`回复邮件 30m`，默认占据时长在设置里可调）。 - 动态推移：随着现实时间流逝，图表上的红色实时指针会无情地前进；所有没打勾的弹性待办事项，总是会被红针自动“推”到未来的空白时间段中。 - 享受免焦虑时间管理的乐趣吧！ - [[April 10th, 2026]] - Add quarter-aware **Custom symbols** for use with `:q` - Examples are `dnp/this-quarter-start`, `ms/this-quarter-start`, `ms/+1Q-start`, `ms/+1Q-end`, `ms/this-quarter-end`, `ms/last-quarter-start` - [Datalog block query](https://roamresearch.com/#/app/developer-documentation/page/CDPYVl-PE) now supports [our custom symbols and rules]([[Roam-specific :q additions]]) too - fix small bugs re blocks selection in linked refs - [[March 31st, 2026]] - [[Quality of Life Improvements]] ✨ for `:q` - Context - `:q` feature has existed since very early Roam, but we revamped it last year - Teaser into the revamped `:q` - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FCDgZUSitGM.gif?alt=media&token=a36140c6-3719-460d-ace1-13d2f06e9aee) - The new stuff: - `current/main-window-*` constants — 5 new symbols to reference the page/block focused in the main window - New constants available for use in :q - `current/main-window-page-title` **NEW ✨** - `current/main-window-page-uid` **NEW ✨** - `current/main-window-page-id` **NEW ✨** - `current/main-window-block-uid` **NEW ✨** - `current/main-window-block-id` **NEW ✨** - Example - One random old reference of the currently open page - I manually clicked on ... then set sorting to be random set rows per column to a 1 - To test it out, open the query below on the sidebar (shift click) and then go to a page with a lot of references like [[video]] - :q "One random old reference to open page" [:find ?uid ?t :where (refs-page current/main-window-page-title ?b) [?b :create/time ?t] [?b :block/uid ?uid] [(< ?t ms/-365D-start)]] - :q "Page UID" [:find ?uid . :where [?page :node/title current/main-window-page-title] [?page :block/uid ?uid]] - Add `in-dnp-between`, `refs-dnp-between`, `in-or-refs-dnp-between` rules to `:q` - Rules we supported before: - Some new useful inbuilt `rules` to ease writing queries - **New rules we added now:** - `(in-dnp-between ?start-dnp ?end-dnp ?b)` **NEW ✨** - `(refs-dnp-between ?start-dnp ?end-dnp ?b)` **NEW ✨** - `(in-or-refs-dnp-between ?start-dnp ?end-dnp ?b)` **NEW ✨** - also adds convenience rules for single DNP variants - `(in-dnp ?dnp ?b)` **NEW ✨** - `(refs-dnp ?dnp ?b)` **NEW ✨** - `(in-or-refs-dnp ?dnp ?b)` **NEW ✨** - you could already do this, this just makes it simpler/more discoverable - The `?start-dnp` `?end-dnp` and `?dnp` params accept dnp page titles or `dnp/*` style symbols (since they resolve to DNP page titles) - Reference for these symbols: - `dnp` - **Usage notes:** These resolve to page title (i.e. `:node/title`) for the relevant daily note page - `dnp/today` - `dnp/yesterday` - `dnp/tomorrow` - `dnp/-1D` - `dnp/+1D` - `dnp/this-week-start` - `dnp/this-week-end` - `dnp/this-month-start` - `dnp/this-quarter-start` - `dnp/this-year-end` - `dnp/=2025-01-01` - resolves to "January 1st, 2025" - Examples of queries our new `in-dnp-between`, `refs-dnp-between`, `in-or-refs-dnp-between` enable [[Examples of :q query blocks]] - (this roam graph does not have much content in daily note pages, so below queries will probably be empty, please copy and test in your own graphs) - DNP blocks this month with create time - `(in-dnp-between dnp/this-month-start dnp/this-month-end ?b)` - :q "DNP blocks this month with create time" [:find ?b ?t :where (in-dnp-between dnp/this-month-start dnp/this-month-end ?b) [?b :create/time ?t]] - TODOs from last week's daily notes or reffing those DNPs - `(in-or-refs-dnp-between dnp/last-week-start dnp/last-week-end ?b)` - :q "TODOs from last week's daily notes or reffing those DNPs" [:find ?b :where (in-or-refs-dnp-between dnp/last-week-start dnp/last-week-end ?b) (refs-page "TODO" ?b)] - Blocks referencing this week, written by particular user "Baibhav Bista" - `(refs-dnp-between dnp/this-week-start dnp/this-week-end ?b)` - :q "Blocks referencing this week, written by Baibhav" [:find ?b :where (refs-dnp-between dnp/this-week-start dnp/this-week-end ?b) (created-by "Baibhav Bista" ?b) [?b :create/time ?t]] - Blocks referencing this week, written by particular user "Baibhav Bista" (also filter out blocks already in those DNPs) - `(refs-dnp-between dnp/this-week-start dnp/this-week-end ?b) (not (in-dnp-between dnp/this-week-start dnp/this-week-end ?b))` - :q "Blocks referencing this week, written by Baibhav" [:find ?b :where (refs-dnp-between dnp/this-week-start dnp/this-week-end ?b) (not (in-dnp-between dnp/this-week-start dnp/this-week-end ?b)) (created-by "Baibhav Bista" ?b) [?b :create/time ?t]] - Expose the custom :q symbols and rules to [roamAlphaAPI.data.q](https://roamresearch.com/#/app/developer-documentation/page/SI3FNt3EQ) - so now extension developers can just use custom symbols like `ms/next-week-start` or rules like `(in-or-refs-dnp-between ?start-dnp ?end-dnp ?b)`, as well as everything else in [[Roam-specific :q additions]] - Change to how  `ms/*` and `dnp/*` symbols are resolved when in daily note pages - Now it works similarly to how `{between: [[today]] [[tomorrow]]}` in `{{query: ....}}` works - that is, when the `:q` query is on a daily note page, `ms/today-start` (for example) resolves to the start of day for the day corresponding to that daily note page. - wheras, for `:q` queries in any other (non-DNP) page, `ms/today-start` corresponds to the actual today - this change is for all the relative ms/* and dnp/* special symbols - When this happens, one can see an info button with details - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FTUAT9AXtNY.png?alt=media&token=b461f6d5-1c81-4beb-baed-3990a1abf410) - In video form: - {{[[video]]: https://www.loom.com/share/f62d4893563143ae84cdae3640af6eb8}} - New and Revamped resources to learn about `:q` - [[Roam-specific :q additions]] - [[Examples of :q query blocks]] - [[March 30th, 2026]] - [[Bug Fixes]] - Fixed export page failing on blocks that only contain a newline - Fixed [[All Pages]] delete page skips user pages instead of failing - [[March 24th, 2026]] - [[Quality of Life Improvements]] - Inline autocomplete [[Search]] - Inline autocomplete now shows a live preview of pages and blocks. - Toggle it with `Ctrl-O` - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2F9NeqRPqlRY.gif?alt=media&token=8f822705-785c-415a-88b1-551a73928a0a) - Search results highlight matching terms and truncate long blocks to keep results scannable - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FbOegvHYIPK.png?alt=media&token=4c144530-be49-4ffc-bc9f-47ccf2b3db3d) - Reference counts are shown next to pages in autocomplete so you can gauge relevance at a glance - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FAr9bHFfZRz.png?alt=media&token=b962b26d-9464-4845-8574-daa2617ecc65) - You can also disable this in user preferences - Added attachment transfer for [[Local Graph]]s - Added attachments view in settings for [[Local Graph]]s - [[Bug Fixes]] - Fix displaying titles like `[[> title]]` in blocks, before this mistakenly displayed a block quote - Fixed the "Click here to update" button sometimes not updating - [[March 11th, 2026]] - [[Quality of Life Improvements]] - Improved [[All Pages]] load time by 50% and now preserves the selected view/sort for the duration of your session. - [[Roam Depot Extensions]] - **[Chief of Staff](https://github.com/mlava/chief-of-staff)** - An AI assistant embedded in Roam Research. Chief of Staff connects your Roam graph to large language models (Anthropic, OpenAI, Google Gemini, or Mistral) and to external tools via [Composio](https://composio.dev/), letting you ask questions, search and manage tasks, and orchestrate actions across your connected apps — all without leaving Roam. - {{[[video]]: https://www.loom.com/share/9aa3c07de0f147af971d2fc54fe65e4a}} - **Object Metadata Autocomplete** - A Roam Research extension that lets you search for real-world objects (books, places, and more) and create structured pages with their metadata. - **Features** - **Book Autocomplete** - Search [OpenLibrary](https://openlibrary.org/) for books and create rich pages with metadata: - Cover image, author(s), publish year, rating, page count, subjects - Author pages are auto-created with `isa::[[person]] [[author]]` - Book link is copied to clipboard and the page opens in the sidebar - **Google Maps Autocomplete** - Search Google Places for locations and create pages with: - Address, coordinates, Google Maps URL, website, vicinity - Location type tags (e.g. `[[restaurant]]`, `[[park]]`) - **Usage** - Open the Roam command palette (`Cmd+P`) and run: - Book autocomplete — search and insert books - Google maps autocomplete — search and insert locations - [[March 9th, 2026]] - [[Quality of Life Improvements]] - Moved all export / import options into a central location in settings - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FD-7v-qinZG.png?alt=media&token=451faf58-1e18-49f4-9b68-5132cac471cd) - Renamed "User" settings to "Preferences" and "Files" to "Attachments" - Changed the styling to limit the width of settings - [[Roam Depot Extensions]] - **DNP Default Filters** - A Roam Research extension that applies default linked references filters to daily note pages. - **Configuration** - Go to Settings > Roam Depot > DNP Default Filters and set: - Includes filter — comma-separated page names to include (e.g. `Queries, Projects`) - Removes filter — comma-separated page names to exclude (e.g. `TODO, Evergreens`) - Auto-apply on navigation — toggle automatic filter application on/off (on by default) - **Features** - **Auto-apply** - When enabled, the extension automatically applies your configured filters to any daily note page's linked references section — both on Roam load (for today's DNP) and whenever you navigate to a DNP. Filters are merged with any existing ones on the page (no duplicates), and only applied once per DNP per session to avoid overwriting manual changes. - **Command palette** - Use Cmd+P (or Ctrl+P) and search for "DNP Filters: Apply to current page" to manually apply filters to whatever daily note page you're currently viewing. This also merges with existing filters. - [[February 27th, 2026]] - [[Quality of Life Improvements]] - Added the ability to choose your own bullet color for multi-user graphs - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FLU1zNLqfi-.png?alt=media&token=c44ba233-a5b7-4fcd-b279-4202a97eaf67) - You can also edit the bullet color of API token's pages you create from their display name page - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FCYsmiXRKg-.png?alt=media&token=7e5f950b-929f-456a-b116-dadbd668b006) - [[February 26th, 2026]] - [[Quality of Life Improvements]] - Speed up the opening of [[Unlinked References]] - Added TSX [[Code Block]]s - [[Bug Fixes]] - **Blockquote and callout paste/import fixes** — Pasting or importing blockquotes and callouts from HTML (e.g. from web pages) and Markdown now correctly produces single Roam quote blocks. Previously, multi-paragraph blockquotes would create separate blocks for each line. Consecutive `>` lines in Markdown imports are now grouped into a single blockquote block. - **Blockquote viewer improvements** — The blockquote and callout viewer now properly handles the `>` prefix, including multi-line blockquotes and cases where `>` is not followed by a space. Previously, the first character after `>` could be clipped. - **Blockquote and callout copy as HTML** — Copying blockquote and callout blocks now produces proper `
` HTML on the clipboard, so pasting into other apps preserves the quote formatting. - Fix some issues pasting from github - [[Roam Depot Extensions]] - **Quick Capture shortcut** - Allows a quick-capture experience without having to change context of whatever you're working on. Just press a hotkey and start typing! - ![](https://camo.githubusercontent.com/9758bd3c25bec18d5cd362987139b3ba0e4c0864c4420431fd622636c0878adb/68747470733a2f2f63646e2e6c6f6f6d2e636f6d2f73657373696f6e732f7468756d626e61696c732f64363235666638623565343934396432626464313466373931643161653333332d303538396330333266633439386562372d66756c6c2d706c61792e676966)[🔗](https://www.loom.com/share/d625ff8b5e4949d2bdd14f791d1ae333) - **How It Works** - Press the hotkey (Ctrl+Shift+N on Mac, Alt+N on Windows/Linux) to: - Create a new block at the bottom of today's Daily Notes page. - Open that block in the right sidebar. - Focus the cursor on it, ready for typing. - You can customize the hotkey from the Command Palette. - **Export with References** - Export a Roam page or block — along with all its backlinks — to your clipboard in markdown format. - For each backlink, the referencing block and all its children are included, grouped by source page. - **Usage** - **Commands** - The extension registers three entry points: - {{[[table]]}} - Trigger - Command - Behavior - Command palette - Export with References - Exports the focused block (if cursor is in a block) or the current page (if no block is focused) - Command palette - Export Page with References - Always exports the entire current page, regardless of which block is focused - Block context menu - Export with References - Right-click a block bullet → exports that specific block - **From the Command Palette** - Navigate to a page, or focus on a block - Open the command palette (`Cmd/Ctrl + P`) - Search for Export with References or Export Page with References - The markdown is copied to your clipboard - **From the Context Menu** - Right-click on a block's bullet point - Select Export with References - The block content and its backlinks are copied to your clipboard - **Output Format** - The exported markdown looks like this: - ```plain text # Page Title- first block on the page - nested child block - second block ## Backlinks### [[Source Page A]]- block that references the exported page - child of the referencing block - another child ### [[Source Page B]]- another referencing block``` - `[[page references]]` are preserved as-is - If there are no backlinks, the "Backlinks" section is omitted - Children of each backlink block are included with proper indentation - **Installation** - Search for Export with References in the [Roam Depot](https://roamresearch.com/#/app/roamjs/page/rmGPdf3tS) marketplace and click install. - **Roam Deep Research** - Run long-form research jobs from inside Roam, poll/stream results from external providers, and write structured output back into your graph. - **Purpose** - This extension gives you a single command-palette workflow to: - dispatch a research prompt to a provider (`Gemini`, `OpenRouter`, or `Manus`) - track job state (`dispatched`, `polling`/`streaming`, `writing`, terminal states) - write a structured result tree under a `Deep Research task::` block - keep job metadata and status in extension settings for recovery and retries - **Requirements** - A valid API key for at least one supported provider (Gemini, OpenRouter, or Manus). - The Manus provider requires Roam's built-in CORS proxy (`corsAnywhereProxyUrl`). The extension will display an error if the proxy is unavailable. - **Core Functions** - **1) Job Dispatch** - Command palette: `Run Deep Research task` - Slash command: `/Run Deep Research task` (runs against the current block) - Prompt UI uses `iziToast` input modal - Context is collected from selected/focused Roam blocks with safety limits: - block cap - character cap - API call budget - depth cap - **2) Provider Execution Modes** - `Gemini`: polling mode via `/v1beta/interactions` - `Manus`: polling mode via `/v1/tasks` (through Roam CORS proxy) - `OpenRouter`: streaming mode via SSE (`/api/v1/chat/completions`) - **3) Status + Recovery** - Cross-tab lease ownership for polling/writeback - Persisted job state in `extensionAPI.settings` - On load: - resumes eligible polling jobs - marks stale streaming jobs failed (streaming cannot resume after reload) - runs maintenance/pruning - **4) Writeback** - Writes output as Roam blocks with batching and depth/size limits - Adds `results_written:: true` marker for idempotency - Includes sections such as: - `Summary::` - `Key Findings::` - `Evidence / Citations::` - `Open Questions::` - `Suggested Next Actions::` - `Attachments::` - `References::` - `Provenance::` - **5) Cancellation + Retry** - Command palette: `Cancel Deep Research task` - Provider-aware cancellation: - Gemini: DELETE interaction - Manus: DELETE task, with local fallback - OpenRouter: abort stream - Retry path reuses prompt and current context collection flow - **6) Tools API** - Registers a public tools bridge at: - `window.RoamExtensionTools['deep-research']` - Tools: - `rdr_run_research` - `rdr_get_jobs` - `rdr_cancel_job` - Broadcast events: - `rdr:job-dispatched` - `rdr:job-completed` - `rdr:job-failed` - `rdr:job-canceled` - **Settings (UI)** - Settings shown in the extension panel and their behaviour impact:`Research provider`Values: `gemini`, `openrouter`, `manus`Changes runtime path (polling vs streaming), API auth, and provider normalisation.Provider key + model/profile`gemini`:`Gemini API key``Research agent` (currently fixed to `deep-research-pro-preview-12-2025`)`openrouter`:`OpenRouter API key``Research model` (select from curated deep-research models)`manus`:`Manus API key``Agent profile` (`manus-1.6`, `manus-1.6-lite`, `manus-1.6-max`)`Max job duration (minutes)`Upper wall-clock bound before a polling job is abandoned.`Max output blocks`Hard cap for writeback size and truncation behaviour.`Store raw output on schema errors`Adds raw provider payload blocks when structured parsing fails.`Archive completed jobs`Moves old terminal jobs to monthly archive pages before cleanup.`Upload attachments to Roam` - Downloads provider attachments, uploads to Roam storage, and embeds if possible. - Manus is one provider that specifically provides files that can be downloaded and stored within Roam Research storage if this setting is switched on. - **Limitations** - Streaming jobs (OpenRouter) cannot survive a page reload. If the tab is closed or refreshed mid-stream, the job is marked failed. Polling providers (Gemini, Manus) automatically resume after reload. - Only one research job can run at a time. - **Data + Safety Notes** - API keys are stored in Roam extension settings (browser IndexedDB), not encrypted. - The extension avoids overwriting non-empty user blocks by creating sibling/fallback roots where possible. - Large output is truncated to respect block/size/depth safety limits. - [[February 25th, 2026]] - [[Quality of Life Improvements]] - [[Import]] dialog redesign with a two-panel layout — scrollable page list on the left, detail panel on the right - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FjeXoRCKlI6.png?alt=media&token=c0023c8b-b862-4847-a1bd-74c6e83ef1a1) - As well as a lot more improvements - Added folder selection for importing entire directories of markdown files - Subfolder paths are now reflected in page titles (e.g. notes/Claim instead of Claim) to avoid false duplicates - Added per-page title editing with option to update [[references]] across all imported pages - Identical pages are auto-unchecked and dimmed; empty pages that already exist in the graph are flagged - Block UID conflicts are now automatically remapped instead of failing the import - Added callout directing users to Image Import for image files from another graph - Fixed Select All / Deselect All being slow on large imports - Improved performance for imports with many pages (500+) - [[February 22nd, 2026]] - [[Quality of Life Improvements]] - [[File Manager]] - Import / Export files, useful when restoring your graph to a new one, or backing up your files - When exporting to the same directory twice, it will not duplicate the files - Currently only supported in the desktop app, chome and edge browsers - Small redesign from a list into a grid - [[February 19th, 2026]] - [[Mobile Native View]] - Added callouts - [[>]] [[!TIP]] Callouts are here! Try typing `> [!warning] Watch out` in any block. See the [[Callouts]] page for all available types and how to style your own custom ones - Fixed Markdown links with parentheses - Fixed applying templates that include headings or text align - Pasting a URL over selected text now creates a Markdown link (like the web app) - Fixed [[iOS]] pasted text disappear after accepting paste - [[Quality of Life Improvements]] - Four / five backtick code blocks, useful for writing markdown in code blocks. - Create with `/markdown` - [[February 18th, 2026]] - [[Quality of Life Improvements]] - `/code block` slash command now inserts at the cursor position instead of replacing the entire block content - `{{date}}` picker now auto-focuses today's date on open, so arrow keys work immediately for keyboard navigation - Selecting a date in the `{{date}}` picker now refocuses the block with the cursor placed after the inserted page reference - [[Roam Depot Extensions]] - **tldraw** - Turn any matching page into a fast, visual whiteboard with draggable page and block nodes, quick linking, and keyboard-friendly canvas controls. - **Notice! This is a beta extension.** - This extension is in active development and may contain bugs. - If you notice anything off, or have feature requests, please reach out on GitHub or Slack. - **Features** - Auto load a canvas on pages that match your patterns (default: `Canvas/*`) - Works in both the main view and right sidebar - Adds dedicated Page and Block node tools to the tldraw toolbar - Supports paste and drag/drop of links and block refs directly onto the canvas - Includes a searchable inspector for picking target pages or blocks - Opens linked items in the main view (`Ctrl+click`) or sidebar (`Shift+click`) - Provides a configurable maximize hotkey for full-screen focus - **Quick Start** - The default canvas page pattern is `Canvas/*`. - To create a canvas, create a page with a title like: - `Canvas/Project Planning` - `Canvas/Ideas` - When you open that page, the canvas loads automatically. - [[February 11th, 2026]] - [[New Features]] - [[>]] [[!TIP]] Callouts are here! Try typing `> [!warning] Watch out` in any block. See the [[Callouts]] page for all available types and how to style your own custom ones - [[Quality of Life Improvements]] - Copy inline code block with right click -> "copy code" button - [[February 10th, 2026]] - [[Quality of Life Improvements]] - Markdown links now support urls with parenthesis in them, as well as `[]()` for other urls which might not display right - `[Mathematical theory](https://en.wikipedia.org/wiki/Theory_(mathematics))` - `[title ...]()` - wrapping a url in `<>` should always work, no matter then special characters in the URL - [[Bug Fixes]] - Fixed a bug that caused data loss in code blocks - Code blocks now save progress while you are typing in them, no need to click outside to save anymore - Fixed a bug with code blocks where pasting + changing the language would open, then close the language picker without letting you select a language - [[Roam Depot Extensions]] - **Breadcrumbs** - Never lose your place in Roam again. Breadcrumbs adds a clickable trail of your recent pages and blocks in the top bar, so you can jump back instantly and navigate your graph with confidence. [Ask DeepWiki](https://deepwiki.com/RoamJS/breadcrumbs) - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2F8kTyi7mpNe.png?alt=media&token=a8c20ab4-f1bc-4214-a554-79086e97853e) - **Features** - Tracks recently visited pages and block locations - Renders oldest-to-current breadcrumb trail in the top bar - Click any non-current breadcrumb to navigate back - Distinguishes pages vs blocks with different styles - Supports Blueprint dark mode (`.bp3-dark`) - **Settings** - `Max breadcrumbs`: max number of prior locations to keep - `Truncate length`: max label length before truncation - **Sticky Notes** - Quick, ephemeral notes that float on top of your Roam Research graph. Jot something down, drag it wherever you want, and when you're done—remove it. No clutter, no permanent page unless you want one. [Ask DeepWiki](https://deepwiki.com/RoamJS/sticky-notes) - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FAMz6_lODQk.png?alt=media&token=8cc8e968-2e77-4498-b736-a53dd18ab82b) - **What are Sticky Notes?** - Sticky Notes are lightweight notes that sit in a layer above your Roam graph. They're meant for quick, temporary capture: ideas you're playing with, reminders for the current session, or scratch space while you work. When you delete a sticky note, it's gone—the block is removed from your graph. No archive, no cleanup later. - **Features** - Full Roam inside every note — Each sticky is a real Roam block. Use tags `#like-this`, images, embeds, links, and everything else you normally do in Roam. - Drag anywhere — Grab the note by the header bar and drag it anywhere on your screen. Position and size are remembered for your session. - Resize — Drag the corner or edge of a note to make it bigger or smaller. - Minimize — Collapse a note to just its title bar when you want it out of the way but still visible. - Ephemeral by design — Delete a note with the ✕ button and the block is removed from Roam. Perfect for throwaway thoughts and temporary scratch space. - **How to use** - Create a sticky note — Open the command palette (`Ctrl/Cmd + Shift + P`), run "Sticky Notes: Create Sticky Note", and a new note appears. - Move it — Click and drag the colored header bar to place the note wherever you like. - Edit — Type in the note as you would in any Roam block. Use `#tags`, `/commands`, images, and links. - Remove it — Click the ✕ on the note when you're done. The note and its content are deleted from your graph. - Sticky notes are stored under a single Roam page (`roam/js/sticky-note`) so they stay in your graph while they exist, but the extension is built so you can treat them as disposable: create, use, delete. - **Stats** - Know your graph in seconds—pages, words, links, and tags in one sleek drawer. [Ask DeepWiki](https://deepwiki.com/RoamJS/stats) - ![](https://firebasestorage.googleapis.com/v0/b/firescript-577a2.appspot.com/o/imgs%2Fapp%2Fhelp%2FDIGMiHQbFg.png?alt=media&token=4c5ce8ca-2890-46f4-b4e8-a7db5b37ba1e) - **Features** - Overview — Pages, interconnections (block refs), Firebase links, external links - Content breakdown — Text blocks (count, words, characters), block quotes, code blocks - Block types — Counts for TODO, DONE, query, embed, table, kanban, video, roam/js (click a tag to open that page) - Account — Current user display name and email - Open the drawer via the command palette: Stats: Toggle Stats Drawer. - [[January 30th, 2026]] - [[Roam Depot Extensions]] - **[YouTube Transcript Sync](https://github.com/qcrao/roam-yts)** - A Roam Research extension that fetches YouTube video transcripts and inserts them into your graph. - ![Demo](https://github.com/qcrao/roam-yts/raw/main/assets/demo.png?raw=true)[🔗](https://github.com/qcrao/roam-yts/blob/main/assets/demo.png?raw=true) - **Features** - Import transcripts from any YouTube video with captions - Clickable timestamps that jump to the video position - Multiple format options: nested blocks, single block, or code block - **Installation** - Go to Settings > Roam Depot > Community Extensions - Search for "YouTube Transcript Sync" - Click Install - **Setup** - Get your API key from [supadata.ai](https://supadata.ai/) (free tier includes 100 credits/month - enough for daily use) - Open Settings > YouTube Transcript Sync - Enter your API key - ![Settings](https://github.com/qcrao/roam-yts/raw/main/assets/settings.png?raw=true)[🔗](https://github.com/qcrao/roam-yts/blob/main/assets/settings.png?raw=true) - **Usage** - Paste a YouTube URL in any block (e.g., `https://youtube.com/watch?v=...`) - Click on the block containing the URL - Open command palette (`Cmd/Ctrl + P`) and run Import Youtube Transcript - Tip: To enable clickable timestamp navigation, click the small button before the YouTube link to embed the video. Without embedding, transcripts will still be imported but timestamps won't jump to the video position. - ![Usage](https://github.com/qcrao/roam-yts/raw/main/assets/usage.png?raw=true)[🔗](https://github.com/qcrao/roam-yts/blob/main/assets/usage.png?raw=true) - **Transcript Formats** - {{[[table]]}} - Format - Description - Nested Blocks - Each segment as a child block with clickable timestamp - Single Block - All text in one block with soft line breaks and clickable timestamps - Code Block - Plain text in a code block (timestamps are not clickable) - ![single block](https://github.com/qcrao/roam-yts/raw/main/assets/single%20block.png?raw=true)[🔗](https://github.com/qcrao/roam-yts/blob/main/assets/single%20block.png?raw=true) - ![code block](https://github.com/qcrao/roam-yts/raw/main/assets/code%20block.png?raw=true)[🔗](https://github.com/qcrao/roam-yts/blob/main/assets/code%20block.png?raw=true) - [[January 16th, 2026]] - [[Bug Fixes]] - Fixed outline highlight priority so selected blocks (blue) display over search highlights (yellow) - Removed extra margin on block highlight outline - Fixed shift-click on Daily Notes in sidebar to properly open today's page - Fixed page title sync to properly update when title changes in the database - When renaming a page causes a merge with an existing page: - Main window now only navigates to the merged page if you had the deleted page open - Sidebar windows showing the deleted page now navigate to the merged page instead of closing - [[Quality of Life Improvements]] - Increased bottom padding on pages from `120px` to `35vh` for more scroll room - [[Roam Depot Extensions]] - **Better Command Palette (BCP)** - Better Command Palette enhances Roam Research’s command palette by letting you pin your favourite commands so they always appear at the top. You can also sort unpinned commands alphabetically if that’s your preference. - This extension is intentionally lightweight, safe, and non-invasive: - ✅ Does not modify your graph (no block/page writes) - ✅ Does not override Roam commands - ✅ Works entirely at the UI layer (DOM decoration + reordering) - **✨ Features** - **⭐ Pin favourite commands** - Click the star next to any command to pin it - Pinned commands move to the top instantly - A divider is shown between pinned and unpinned commands (when both exist) - **💾 Per-graph persistence** - Your pinned commands are stored in Roam Depot settings for this graph - Pins are restored every time you open the command palette - **🔤 Sort unpinned commands** - Choose Roam native, A → Z, or Z → A in settings - Optionally override the sort mode for the current command-palette session using the footer buttons - Note: pinned commands are always shown in A → Z order for stability. - **⚡ Fast & safe** - Only activates while the command palette is open - Uses scoped `MutationObserver`s to react to Roam UI changes - No polling, no key simulation, no DOM cloning - **🖱 Usage** - Open the command palette (`Cmd–P` / `Ctrl–P`) - Click the ☆ star next to any command to pin it - Pinned commands appear at the top immediately - Click ★ to unpin - The extension also adds three small buttons in the footer of the Command Palette. These allow you to override your global sort preference on a per-session basis. - Footer sort overrides apply only to the current palette session and reset when the palette closes. - **⚙️ Settings** - This extension uses Roam Depot settings: - Sort mode: `Roam native` / `A → Z` / `Z → A` - Pinned commands storage: saved automatically as you pin/unpin - Clearing the extension’s settings resets all pins and returns sorting to Roam native. - **🧠 How it works** - Watches for the Command Palette modal to appear - Decorates each command with a star button - Tracks pinned commands by a stable key derived from: - label text, and - shortcut (when present) - Reorders the menu in place using Roam’s existing DOM nodes - Resets cleanly when the palette closes - **♿ Accessibility** - Stars and sort controls are implemented as real `