Agent skill

Pp Roam

by mvanhorn in mvanhorn/printing-press-library

Every Roam HQ surface — chat, transcripts, On-Air events, SCIM, webhooks — in one local-first CLI with offline...

Apache-2.0Auto-check: notesBackend & APIs

Install Pp Roam

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-roam -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-roam --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-skills/pp-roam .claude/skills/pp-roam && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "pp-roam" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-roam into .claude/skills/pp-roam/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-roam", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-roam

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-roam -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-roam --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .agents/skills && cp -r skills-src/cli-skills/pp-roam .agents/skills/pp-roam && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "pp-roam" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-roam into .agents/skills/pp-roam/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-roam", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-roam -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-roam --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/cli-skills/pp-roam .cursor/skills/pp-roam && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "pp-roam" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-roam into .cursor/skills/pp-roam/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-roam", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/mvanhorn/printing-press-library.git --path cli-skills/pp-roam

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-roam -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-roam --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/cli-skills/pp-roam .gemini/skills/pp-roam && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "pp-roam" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-roam into .gemini/skills/pp-roam/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-roam", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-roam

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-roam -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .github/skills && cp -r skills-src/cli-skills/pp-roam .github/skills/pp-roam && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "pp-roam" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-roam into .github/skills/pp-roam/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-roam", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mvanhorn/printing-press-library --skill pp-roam -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install mvanhorn/printing-press-library pp-roam --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mvanhorn/printing-press-library.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/cli-skills/pp-roam .opencode/skills/pp-roam && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "pp-roam" agent skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-roam into .opencode/skills/pp-roam/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pp-roam", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: pp-roam
GitHub stars: 2.1k
Token cost: ~6k tokens
SKILL.md length: 2,728 words
Files: 1
Skills in repo: 506
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Every Roam HQ surface — chat, transcripts, On-Air events, SCIM, webhooks — in one local-first CLI with offline...

Works in 3 steps: Install via the Printing Press… → Verify: roam-pp-cli --version → Ensure the reported install directory is…
Phrases: search roam transcripts
SKILL.md covers Prerequisites: Install the CLI, When to Use This CLI, Unique Capabilities and Command Reference, plus 10 more sections
Calls claude, npx and go; needs ROAM_API_KEY

What it does

Pp Roam is an agent skill from mvanhorn/printing-press-library. 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.

Its SKILL.md is about 6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Webhooks. The repository describes itself as: Official library of CLIs generated by the CLI Printing Press. Endorsed, tested, and community-contributed. The licence is Apache-2.0.

When your agent uses it

Phrases: search roam transcripts
Post a message to roam
What did we decide in roam
Roam attendance report

Example prompts

“/pp-roam”

Requirements

Node.js
Pre-approved tools (allowed-tools): Read, Bash

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and…
Verify: roam-pp-cli --version
Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

What it can do on your machine

Read from SKILL.md and the folder at commit 76de244. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Read
- Bash
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- claude
- npx
- go
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- ROAM_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pp Roam loads about 6k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 2,728 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~71
When it runs · the whole SKILL.md, loaded when a task matches: ~6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Read, Bash
```

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mvanhorn/printing-press-library at commit 76de244, republished under its Apache-2.0 licence (© mvanhorn). 2,728 words, ~6,000 tokens.

Download SKILL.mdSave it as .claude/skills/pp-roam/SKILL.md (or your agent's skills folder).

name: pp-roam
description: 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`.
allowed-tools: Read, Bash
author: Greg Van Horn
license: Apache-2.0
argument-hint: <command> [args] | install cli|mcp

<!-- 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:

Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
bash
```
npx -y @mvanhorn/printing-press-library install roam --cli-only
```
Verify: roam-pp-cli --version
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):

bash

go install github.com/mvanhorn/printing-press-library/library/productivity/roam/cmd/roam-pp-cli@latest

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.
bash
```
roam-pp-cli grep "pricing" --since 14d --in-group eng --json --select transcript_id,line
```
decisions — Surface decision-shaped lines ("we decided", "action item", "agreed", "let's go with") from synced transcripts.

Use when an agent owes the team a Monday recap; deterministic and citation-bearing.
bash
```
roam-pp-cli decisions --since 7d --in-group product --agent
```
onair-attendance-drift — Compare invited guests vs actual attendance for an On-Air event; print invited-no-show and walk-in sets.

Use when an agent is asked who didn't show or who attended without an invite.
bash
```
roam-pp-cli onair-attendance-drift --event evt_123 --json
```
webhook-tail — Tail recent webhook deliveries from the local subscription registry, --since filtered.

Use when debugging a webhook integration without standing up a listener.
bash
```
roam-pp-cli webhook-tail --since 1h --json
```
mention-inbox — Local FTS over messages.text for @user tokens with --since filter; tail format.

Use when an agent must surface unread mentions across all groups without round-tripping the API per group.
bash
```
roam-pp-cli mention-inbox --user @me --since 7d --agent
```

Mutation safety

onair-reaper — Find recurring On-Air events with zero attendance over N days. --apply cancels them via the absorbed cancel endpoint.

Use when cleaning up dead recurring events; safe by default.
bash
```
roam-pp-cli onair-reaper --stale-days 60 --dry-run
```
scim-diff — Diff a CSV/JSON HRIS roster against /Users SCIM list; print add/update/remove sets. --apply runs SCIM CRUD.

Use when an agent needs to reconcile an external roster with Roam membership without clicking through admin UI.
bash
```
roam-pp-cli scim-diff --roster hris.csv --apply --dry-run
```

Agent-native plumbing

transcript-fanout — Run a single question against every transcript in a date range; one row per transcript with answer + citation.

Use when an agent must scan many meetings for a single question without re-prompting each one.
bash
```
roam-pp-cli transcript-fanout --question "did anyone mention Q3 hiring?" --since 30d --agent
```
relay — Pipe arbitrary stdin lines into a Roam group via /chat.post with deterministic idempotency keys and 429 backoff.

Use when an agent needs to forward a stream (CI, alerts, logs) into Roam without writing a custom webhook.
bash
```
tail -F deploys.log | roam-pp-cli relay --to eng-deploys --idempotent-key-prefix deploys
```

Reachability mitigation

doctor token — Probe one representative GET per spec family (HQ, On-Air, Chat, SCIM, Webhooks) and print which families this key can reach.

Use when an agent needs to know which Roam commands will work with the credential it has before attempting them.
bash
```
roam-pp-cli doctor token
```

Command Reference

addr-info — Manage addr info

roam-pp-cli addr-info — Get information about a chat address, which is the name for any entity that may participate in a chat, such as a...

app-uninstall — Manage app uninstall

roam-pp-cli app-uninstall — Revoke an access token and uninstall your app. On successful response, your access token will no longer be...

chat-delete — Manage chat delete

roam-pp-cli chat-delete — Delete a previously posted bot message. The bot must own the message being deleted (matched by address ID). Personal...

chat-history — Manage chat history

roam-pp-cli chat-history — List messages in a chat, filtered by date range (after/before). The ordering of results depends on the filter...

chat-list — Manage chat list

roam-pp-cli chat-list — List all accessible chats, which consist of all DMs, MultiDMs, and Channels that your bot has been added to, in...

chat-post — Manage chat post

roam-pp-cli chat-post — Post a message to a chat. Messages can be plain markdown text, rich Block Kit layouts, or...

chat-send-message — Manage chat send message

roam-pp-cli chat-send-message — Sends the given message to the specified recipients. At this time, we only support sending to a single group...

chat-typing — Manage chat typing

roam-pp-cli chat-typing — Notify other chat participants that you are working on a response. If they have the chat open, they will see '(Bot...

chat-update — Manage chat update

roam-pp-cli chat-update — Edit a previously posted bot message. The updated message can contain plain markdown text or rich [Block...

group-add — Manage group add

roam-pp-cli group-add — Add one or more group members and/or admins. Apps may add members to a group if one of the following conditions is...

group-archive — Manage group archive

roam-pp-cli group-archive — Archive a group by ID. Access: Organization only. Required scope: group:write --- OpenAPI Spec:...

group-create — Manage group create

roam-pp-cli group-create — Create a group address that can be used for chat. Groups which specify an admin will operate in an 'Admin only'...

group-members — Manage group members

roam-pp-cli group-members — List members in a group. Apps may list members if one of the following conditions is true: 1. It is a public group...

group-remove — Manage group remove

roam-pp-cli group-remove — Remove one or more group members. Apps may remove members from a group if one of the following conditions is true:...

group-rename — Manage group rename

roam-pp-cli group-rename — Rename a group by ID. Apps may only rename groups for which they are an admin. Access: Organization only....

groups — Manage groups

roam-pp-cli groups 02-create — Creates a new group in your Roam organization. Required fields: displayName (max 64 characters). Optional:...
roam-pp-cli groups 02-delete — Archives a group in Roam. This is a soft delete — the group data is retained but becomes inactive....
roam-pp-cli groups 02-get — Retrieves a single group by its Roam Address ID. The response includes the group's displayName and members array...
roam-pp-cli groups 02-list — Returns a paginated list of groups in your Roam organization. Pagination: Use startIndex (1-based) and count...
roam-pp-cli groups 02-patch — Partially updates a group. Use this to add or remove members without replacing the entire group. **Supported...
roam-pp-cli groups 02-replace — Fully replaces a group's attributes. The entire members list is replaced with the provided values. **Required...

groups-list — Manage groups list

roam-pp-cli groups-list — Lists all public, non-archived groups in your home Roam. Access: Organization only. Required scope:...

item-upload — Manage item upload

roam-pp-cli item-upload — Upload a file so that it can be sent as a chat message attachment. The returned object contains an item ID which can...

lobby-booking-list — Manage lobby booking list

roam-pp-cli lobby-booking-list — Lists bookings for a specific lobby configuration, filtered by date range (after/before). The ordering of results...

lobby-list — Manage lobby list

roam-pp-cli lobby-list — Lists active lobbies in your account. A lobby URL has the form ro.am/{handle} or ro.am/{handle}/{slug}. - The...

magicast-info — Manage magicast info

roam-pp-cli magicast-info — Retrieve a magicast by ID. Access: Organization and Personal. In Personal mode, only magicasts owned by the...

magicast-list — Manage magicast list

roam-pp-cli magicast-list — Lists all magicasts in your Roam, sorted in reverse chronological order. Access: Organization and Personal. In...

meeting-list — Manage meeting list

roam-pp-cli meeting-list — Lists all meetings in your home Roam, filtered by date range (after/before). The ordering of results depends on the...

meetinglink-create — Manage meetinglink create

roam-pp-cli meetinglink-create — Create a meeting link. Access: Organization and Personal. In Organization mode, specify the host by email. In...

meetinglink-info — Manage meetinglink info

roam-pp-cli meetinglink-info — Get a meeting link. Access: Organization only. Required scope: meetinglink:read --- OpenAPI Spec:...

meetinglink-update — Manage meetinglink update

roam-pp-cli meetinglink-update — Update a meeting link. Access: Organization only. Required scope: meetinglink:write --- OpenAPI Spec:...

messageevent-export — Manage messageevent export

roam-pp-cli messageevent-export — Obtain a daily message event export containing DMs and group chats within your account. For customers with archival...

onair-attendance-list — Manage onair attendance list

roam-pp-cli onair-attendance-list — Returns the attendance report for an On-Air event, combining RSVP data with join/duration information. Guests with...

onair-event-cancel — Manage onair event cancel

roam-pp-cli onair-event-cancel — Cancels an On-Air event. This action cannot be undone. Access: Organization and Personal. Required scope:...

onair-event-create — Manage onair event create

roam-pp-cli onair-event-create — Creates a new On-Air event. The calendar host must be a member of the organization. When using a personal access...

onair-event-info — Manage onair event info

roam-pp-cli onair-event-info — Returns details for a single On-Air event. Access: Organization and Personal. Required scope: onair:read...

onair-event-list — Manage onair event list

roam-pp-cli onair-event-list — Returns a paginated list of On-Air events for the organization. Results are sorted by start time in descending order...

onair-event-update — Manage onair event update

roam-pp-cli onair-event-update — Updates an existing On-Air event. Only the fields provided in the request body are updated; omitted fields remain...

onair-guest-add — Manage onair guest add

roam-pp-cli onair-guest-add — Adds one or more guests to an On-Air event. Access: Organization and Personal. Required scope: onair:write...

onair-guest-info — Manage onair guest info

roam-pp-cli onair-guest-info — Returns details for a single On-Air event guest. Access: Organization and Personal. Required scope:...

onair-guest-list — Manage onair guest list

roam-pp-cli onair-guest-list — Returns a paginated list of guests for an On-Air event. Optionally filter by RSVP status. Results are sorted by...

onair-guest-remove — Manage onair guest remove

roam-pp-cli onair-guest-remove — Removes a guest from an On-Air event. Access: Organization and Personal. Required scope: onair:write ---...

onair-guest-update — Manage onair guest update

roam-pp-cli onair-guest-update — Updates the RSVP status of a guest. Access: Organization and Personal. Required scope: onair:write ---...

reaction-add — Manage reaction add

roam-pp-cli reaction-add — Add a reaction to a message in a chat. Access: Organization only. Required scope: chat:send_message or...

recording-list — Manage recording list

roam-pp-cli recording-list — Lists all recordings in your home Roam, filtered by date range (after/before). The ordering of results depends on...

Show full SKILL.md (1,144 more words)Show less

resource-types — Manage resource types

roam-pp-cli resource-types — Returns the list of resource types supported by Roam: User and Group. No authentication required for this...

schemas — Manage schemas

roam-pp-cli schemas 03-metadata-get — Returns the definition of a specific SCIM schema by its URN identifier. No authentication required for this...
roam-pp-cli schemas 03-metadata-list — Returns all SCIM schemas supported by Roam, including the core User and Group schemas plus Roam's custom role...

service-provider-config — Manage service provider config

roam-pp-cli service-provider-config — Returns Roam's SCIM capabilities and supported features. Use this endpoint to discover which SCIM operations are...

test — Manage test

roam-pp-cli test — Test endpoint

token-info — Manage token info

roam-pp-cli token-info — Get information about the access token, such as the Chat Address. Access: Organization and Personal. **No...

transcript-info — Manage transcript info

roam-pp-cli transcript-info — Retrieve a transcript by ID from your home Roam. Works for both completed and live (ongoing) meetings. For live...

transcript-list — Manage transcript list

roam-pp-cli transcript-list — Lists all transcripts in your home Roam, filtered by date range (after/before). This endpoint returns transcript...

transcript-prompt — Manage transcript prompt

roam-pp-cli transcript-prompt — Ask a question about a specific meeting transcript and receive an AI-generated answer based on its content. Use...

user-info — Manage user info

roam-pp-cli user-info — Get detailed information about a single user by ID. Access: Organization only. Required scope: user:read...

user-list — Manage user list

roam-pp-cli user-list — List all users in the account. Users are returned in the order they were added to the account. Access:...

user-lookup — Manage user lookup

roam-pp-cli user-lookup — Look up users in the account by email. Access: Organization only. Required scopes: user:read and...

userauditlog-list — Manage userauditlog list

roam-pp-cli userauditlog-list — Get a list of user audit log entries for the account. Access: Organization only. Required scope:...

users — Manage users

roam-pp-cli users 01-create — Provisions a new user in your Roam organization. Required fields: userName, name.givenName,...
roam-pp-cli users 01-delete — Archives a user in Roam. This is a soft delete — the user's data is retained but they lose access....
roam-pp-cli users 01-get — Retrieves a single user by their Roam Person ID. The response includes all user attributes, the active status, and...
roam-pp-cli users 01-list — Returns a paginated list of users in your Roam organization. Filtering: Supports SCIM filter expressions, e.g.,...
roam-pp-cli users 01-patch — Partially updates a user. Roam supports SCIM PATCH for Users with limited semantics. Supported operations: -...
roam-pp-cli users 01-replace — Fully replaces a user's attributes. You must provide all required fields in the request body. **Roam-specific...

webhook-subscribe — Manage webhook subscribe

roam-pp-cli webhook-subscribe — Create or update a webhook subscription for a given event. If a subscription already exists for the same event and...

webhook-unsubscribe — Manage webhook unsubscribe

roam-pp-cli webhook-unsubscribe — Remove a webhook subscription by ID. Access: Organization only. Required scope: webhook:write ---...

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

bash

roam-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Daily standup digest

bash

roam-pp-cli decisions --since 1d --in-group standup --agent --select transcript_id,line,speaker

Pull yesterday's decisions from the standup group, formatted for agent consumption with citation.

Cross-meeting question scan

bash

roam-pp-cli transcript-fanout --question "did anyone mention Q3 hiring?" --since 30d --agent

Run one question against every transcript in the last 30 days.

Reconcile HRIS roster with Roam SCIM

bash

roam-pp-cli scim-diff --roster hris.csv --apply --dry-run

See add/update/remove sets before applying; drop --dry-run to execute.

Pipe CI alerts into Roam

bash

tail -F /var/log/ci.log | roam-pp-cli relay --to eng-alerts --idempotent-key-prefix ci

Stream CI log lines into a Roam group with deterministic dedupe.

Narrow a deeply-nested transcript response

bash

roam-pp-cli transcript-info --id <id> --json --select segments.speaker,segments.text

Use --select with dotted paths to keep agent context small on long transcripts.

Auth Setup

Bearer auth via ROAM_API_KEY. Roam supports two key tiers: full-access organization keys and personal access tokens. Some HQ v1 endpoints require full-access; Chat/Transcript v0 endpoints work with PATs. Run roam-pp-cli doctor token to see which families your key can reach.

Run roam-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

Pipeable — JSON on stdout, errors on stderr
Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
bash
```
roam-pp-cli addr-info --agent --select id,name,status
```
Previewable — --dry-run shows the request without sending
Offline-friendly — sync/search commands can use the local SQLite store when available
Non-interactive — never prompts, every input is a flag
Explicit retries — use --idempotent only when an already-existing create should count as success, and --ignore-missing only when a missing delete target should count as success

Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

roam-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
roam-pp-cli feedback --stdin < notes.txt
roam-pp-cli feedback list --json --limit 10

Entries are stored locally at ~/.roam-pp-cli/feedback.jsonl. They are never POSTed unless ROAM_FEEDBACK_ENDPOINT is set AND either --send is passed or ROAM_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL (`application/json` or `application/x-ndjson` when `--compact`)

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

roam-pp-cli profile save briefing --json
roam-pp-cli --profile briefing addr-info
roam-pp-cli profile list --json
roam-pp-cli profile show briefing
roam-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Exit Codes

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
4	Authentication required
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

Argument Parsing

Parse $ARGUMENTS:

Empty, help, or --help → show roam-pp-cli --help output
Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:

bash

claude mcp add roam-pp-mcp -- roam-pp-mcp

Verify: claude mcp list

Direct Use

Check if installed: which roam-pp-cli If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the --agent flag:

bash

roam-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help: roam-pp-cli <command> --help.

Files

Just SKILL.md in cli-skills/pp-roam of mvanhorn/printing-press-library.

Open the folder on GitHubat commit 76de244

Compare with similar skills

Pp Roam next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pp Roam compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Pp Roam this skillmvanhorn/printing-press-library	2.1k	—	~6k	Automated safety check: Notes	Apache-2.0	today
Novu Design Workflownovuhq/novu	40k	—	~2.6k	Automated safety check: Pass	Custom licence	today
Golivemikehasa/golive-skill	1.2k	—	~13k	Automated safety check: Notes	MIT	5 days ago
Stripe Appsfossasia/eventyay	1.7k	1 repos	~3.6k	Automated safety check: Pass	Apache-2.0	today
Dingtalk Messageagentscope-ai/ReMe	3.6k	—	~1.6k	Automated safety check: Pass	Apache-2.0	3 days ago
PR Review Provideryansongda/pay	5.4k	—	~2.4k	Automated safety check: Pass	MIT	yesterday

Similar skills

Novu Design Workflow
novuhq/novu
Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state.
40k GitHub stars~2.6k tokensUpdated today
Backend & APIsAuto-check passed
Golive
mikehasa/golive-skill
Take an agent-written app from repo to live production on the user's OWN accounts, with providers they choose (hosting, database, auth, payments, email, domain/DNS).
1.2k GitHub stars~13k tokensUpdated 5 days ago
Backend & APIsAuto-check: notes
Stripe Apps
fossasia/eventyay
A skill your agent uses when building, modifying, or reviewing a Stripe App — or when the user describes something that implies one (e.g.
1.7k GitHub starsUsed in 1 repo~3.6k tokens
Backend & APIsAuto-check passed
Dingtalk Message
agentscope-ai/ReMe
钉钉消息发送技能。支持企业内部机器人（批量单聊/群聊）和 Webhook 自定义机器人两种接入方式，支持多机器人管理，支持文本、Markdown、链接、ActionCard、FeedCard等多种消息类型。
3.6k GitHub stars~1.6k tokensUpdated 3 days ago
Backend & APIsAuto-check passed
PR Review Provider
yansongda/pay
A skill your agent uses when reviewing PRs that add or modify a payment Provider in yansongda/pay - covers plugin pipeline, multi-tenant safety, signature verification, docs, and naming conventions.
5.4k GitHub stars~2.4k tokensUpdated yesterday
Backend & APIsAuto-check passed
Stripe Best Practices
kanchengw/cnllm
Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…
175 GitHub starsUsed in 2 repos~925 tokens
Backend & APIsAuto-check passed

Questions about Pp Roam

What does Pp Roam do?

Every Roam HQ surface — chat, transcripts, On-Air events, SCIM, webhooks — in one local-first CLI with offline... Pp Roam is an agent skill from mvanhorn/printing-press-library. Every Roam HQ surface — chat, transcripts, On-Air events, SCIM, webhooks — in one local-first CLI with offline...

When should I use Pp Roam?

Pp Roam fits situations like: phrases: search roam transcripts; post a message to roam; what did we decide in roam; roam attendance report.

How do I install Pp Roam in Claude Code?

Run `npx skills add mvanhorn/printing-press-library --skill pp-roam -a claude-code`. Or copy the skill folder (cli-skills/pp-roam in mvanhorn/printing-press-library) into .claude/skills/pp-roam in your project. Claude Code loads it when a task matches its description.

How do I install Pp Roam in Codex?

Run `npx skills add mvanhorn/printing-press-library --skill pp-roam -a codex`. Or copy the skill folder (cli-skills/pp-roam in mvanhorn/printing-press-library) into .agents/skills/pp-roam in your project. Codex loads it when a task matches its description.

Can I use Pp Roam in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mvanhorn/printing-press-library --skill pp-roam -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pp-roam, .gemini/skills/pp-roam, .github/skills/pp-roam and .opencode/skills/pp-roam in your project.

What does Pp Roam need to run?

Going by SKILL.md and its folder, Pp Roam needs the command-line tools its instructions call (claude, npx and go) and credentials named ROAM_API_KEY. Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Bash.

Does Pp Roam access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Pp Roam safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pp Roam use?

Pp Roam is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pp Roam use?

About 6k tokens (SKILL.md is roughly 24k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pp Roam?

Skills that share tags, products or a category with Pp Roam: Novu Design Workflow (novuhq/novu, 40k stars), Golive (mikehasa/golive-skill, 1.2k stars), Stripe Apps (fossasia/eventyay, 1.7k stars) and Dingtalk Message (agentscope-ai/ReMe, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pp Roam?

mvanhorn (a GitHub user) maintains it in mvanhorn/printing-press-library, which has 2,056 GitHub stars. The repository holds 506 skills in this directory. The repository was last updated on October 9, 2026.

Source: mvanhorn/printing-press-library on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Pp Roam

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Roam — Printing Press CLI

Prerequisites: Install the CLI

When to Use This CLI

Unique Capabilities

Local state that compounds

Mutation safety

Agent-native plumbing

Reachability mitigation

Command Reference

Finding the right command

Recipes

Daily standup digest

Cross-meeting question scan

Reconcile HRIS roster with Roam SCIM

Pipe CI alerts into Roam

Narrow a deeply-nested transcript response

Auth Setup

Agent Mode

Response envelope

Agent Feedback

Output Delivery

Named Profiles

Exit Codes

Argument Parsing

MCP Server Installation

Direct Use

Files

Compare with similar skills

Similar skills

More from mvanhorn/printing-press-library

Related

Questions about Pp Roam