SDK & CLI

Papyrus is a small terminal app for RR Maps. Use it when you want the research agent to work with papers, notes, drafts, or project files that live on your computer.

Install

One command installs the right build for your Mac or Linux machine:

curl -sSL https://api.rapidreview.io/cli/install | bash
papyrus --help
papyrus doctor
papyrus

The first run opens Papyrus in your terminal and signs you in through the browser.

Human vs agent auth

Humans can run papyrus and sign in through the browser. Agents, CI jobs, and headless sandboxes should use a long-lived API key instead:

export RAPIDREVIEW_KEY="rr_sk_..."
papyrus --headless search "flash attention" --max-results 10

Run papyrus doctor when setup fails. It checks PATH, platform, backend URL, config writability, and auth source without printing secrets.

Three ways to use it

Chat in the terminal. Use this when you want to ask RR Maps research questions from your terminal instead of the browser.

papyrus

Papyrus opens a terminal chat where you can browse sessions, send prompts, and let the agent read files in the folder where you launched it.

Connect a local folder to web chat. Use this when your PDFs, notes, drafts, or project files are on your computer and you want the web chat agent to read that folder.

In web chat, click Connect CLI, copy the token, then paste it into Papyrus:

/connect <token>

The connection belongs only to that chat session, and permissions stay controlled in Papyrus.

Look up papers from the command line. Use this when you want a quick paper search, citation, or related-work lookup without opening the browser.

papyrus search "flash attention" --max-results 10
papyrus paper 1706.03762
papyrus related 1706.03762 --n 15
papyrus ask --timeout 120 "Compare DPO vs PPO for LLM alignment. 3 arxiv ids."

📝

Direct commands like search, paper, and relatedare fast lookups. Use ask for synthesis or judgment, and add--timeout when running unattended.

📝

Run related without --min-score first. Similarity scores vary by field and paper recency; a high threshold can filter real related papers down to an empty list.

Local permissions

Use permissions to decide what one chat session may do with the local folder you connected. By default, the agent can read files in that folder, but it cannot write files or run terminal commands unless you opt in.

`/permissions`	Show current local access
`/permissions read-only`	Let the agent read files only
`/permissions workspace-write`	Let the agent create or edit files in the folder
`/permissions shell-exec`	Let the agent run terminal commands for you
`/permissions terminal on`	Let you run terminal commands with `!`

Use ! when you want to show the agent the result of a quick local command, such as which folder you are in or what files are nearby.

!pwd
!ls

Use !! to send a normal chat message that starts with !.

For agent builders

Agent instruction files do not include the binary. Install papyruson PATH in the same machine or sandbox where the agent runs:

curl -sSL https://api.rapidreview.io/cli/install | bash
export PATH="$HOME/.local/bin:$PATH"
papyrus doctor

The public agent instruction file teaches your agent when and how to call Papyrus:

Download SKILL.md Download install.sh

SKILL.md — tactical playbook: commands, recipes, a decision tree for “user asked X → call Y”.

Each framework has its own convention for where the skill lives:

Claude Code	`~/.claude/skills/papyrus/SKILL.md`
Codex, Copilot, Factory, Augment, Cline, Aider	Add `SKILL.md` through the tool’s custom instruction or skill mechanism
Cursor	`.cursor/rules/papyrus.mdc`
Custom SDK (Anthropic / OpenAI / LangChain)	Injected into the system prompt at boot

Claude Code. Installs as a personal skill, auto-activated when your prompt mentions arXiv, papers, or literature search:

curl -sSL https://api.rapidreview.io/cli/install | bash
mkdir -p ~/.claude/skills/papyrus
curl -sSL https://api.rapidreview.io/cli/skill \
  -o ~/.claude/skills/papyrus/SKILL.md

Codex / Copilot / Factory / Augment / Cline / Aider. Add the public skill text to the tool’s custom instruction, skill, or rule mechanism:

cd your/project
curl -sSL https://api.rapidreview.io/cli/install | bash
curl -sSL https://api.rapidreview.io/cli/skill -o papyrus.SKILL.md

📝

Keep Papyrus instructions separate from existing project instructions when your tool supports skills or rule files; otherwise paste the SKILL.mdcontent into the appropriate custom instruction field.

Cursor. Added as a project rule; the YAML frontmatter (description) tells Cursor when to attach it:

curl -sSL https://api.rapidreview.io/cli/install | bash
mkdir -p .cursor/rules
curl -sSL https://api.rapidreview.io/cli/skill \
  -o .cursor/rules/papyrus.mdc

Custom agents. Fetch the skill at startup and prepend it to the agent’s system prompt:

SKILL=$(curl -sSL https://api.rapidreview.io/cli/skill)
# append $SKILL to your agent's system prompt

💡

The skill URL is stable, public-read, and cached at the edge for ~5 min — safe to refetch on every agent start.

Advanced install options

Most users should use the one-line installer above. If your environment blocks pipe-to-shell installers, download the release archive and checksum directly:

VERSION=$(curl -fsSL https://storage.googleapis.com/rr_cli_releases/latest/VERSION)
TARGET=aarch64-unknown-linux-musl
BASE="https://storage.googleapis.com/rr_cli_releases/$VERSION"
curl -fLO "$BASE/papyrus-$VERSION-$TARGET.tar.gz"
curl -fLO "$BASE/papyrus-$VERSION-$TARGET.tar.gz.sha256"

Replace TARGET with the build for your machine:

aarch64-apple-darwin for Apple Silicon Macs
x86_64-apple-darwin for Intel Macs
x86_64-unknown-linux-musl for Linux x86_64
aarch64-unknown-linux-musl for Linux arm64