Agent skill · software engineering · mvanhorn
pp-roam
Every Roam HQ surface — chat, transcripts, On-Air events, SCIM, webhooks — in one local-first CLI with offline... Trigger phrases: `search roam transcripts`, `post a message to roam`, `what did we decide in roam`, `roam attendance report`, `use roam-pp-cli`, `run roam-pp-cli`.
Why this skill is useful
Adds executable scripts for Roam HQ that automate tasks like searching transcripts and managing attendance reports, which are not available in public documentation.
What it needs
Requires roam-pp-cli installed locally. About 11k tokens when loaded. Last updated 2026-08-06. 1,890 stars on the source repository.
What this skill does
<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/productivity/roam/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". --> Roam — Printing Press CLI Prerequisites: Install the CLI This skill drives the roam-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first: 1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows: 2. Verify: roam-pp-cli --version 3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill. If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer): If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds. When to Use This CLI Reach for roam-pp-cli when you need to script Roam HQ from a shell or agent: tail webhook deliveries, post deploy notifications, search transcripts across many meetings at once, reconcile SCIM membership against an HRIS roster, or extract decisions from last week's recordings. The remote MCP at api.ro.am/mcp is great for ad-hoc agent chat; this CLI is the choice when you want pipelines, cron, or local-first search. Unique Capabilities These capabilities aren't available in any other tool for this API. Local state that compounds grep — Search across every chat message and meeting transcript at once with --since, --from-user, --in-meeting, --in-group filters. Reach for this when an agent needs to recall what was said across many meetings without re-paging the rate-limited transcript API. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mvanhorn/pp-roam