Install

macOS (arm64, x86_64) and Linux (x86_64, arm64). No Windows build.

Install

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

Lands in ~/.local/bin, no sudo. If the shell can’t find nisa, the installer printed the export PATH=… line to add. Rerun it any time to update (nisa upgrade does the same).

nisa

Pick Sign in with your browser (your RapidReview account) or Paste an API key. Browser sign-in also stores a long-lived key on this machine, so agents here need no further setup.

Check

nisa doctor
nisa search "flash attention" --max-results 3

doctor reports install, PATH, backend, and auth (never secrets); search returns three ranked papers.

Before v0.3.0 the CLI was called papyrus. Re-running the installer replaces it: you get nisa, a papyrus symlink so old scripts keep working, and ~/.papyrus/ — your sign-in — moves to ~/.nisa/ on first run.

Keys for scripts and agents

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

Where you signed in through the browser, nothing to do — that stored a key the CLI picks up. Anywhere else, mint one in the web app under Settings → API Keys (or nisa keys create "<name>" while signed in through nisa login; a key can’t manage keys). Treat it as a password.

Give your coding agent the skill

With the CLI on PATH, one more download makes your coding agent use it on its own: the Nisa skill, a SKILL.md that says when to reach for nisa and how. Put it where your agent looks for skills; the folder must be named nisa-cli.

mkdir -p ~/.claude/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.claude/skills/nisa-cli/SKILL.md

Copilot CLI and OpenCode read ~/.claude/skills/ too, so this install covers them as well.

mkdir -p ~/.agents/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.agents/skills/nisa-cli/SKILL.md

Codex reads ~/.agents/skills/ and .agents/skills/ in the repo — not ~/.codex/skills.

mkdir -p ~/.cursor/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.cursor/skills/nisa-cli/SKILL.md

Cursor also accepts ~/.agents/skills/. Skills replace the older .cursor/rules/*.mdc route.

mkdir -p ~/.copilot/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.copilot/skills/nisa-cli/SKILL.md

mkdir -p ~/.gemini/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.gemini/skills/nisa-cli/SKILL.md

Gemini asks for consent the first time the skill activates. /skills disable nisa-cli turns it off.

mkdir -p ~/.qwen/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.qwen/skills/nisa-cli/SKILL.md

mkdir -p ~/.config/opencode/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.config/opencode/skills/nisa-cli/SKILL.md

mkdir -p ~/.kilo/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.kilo/skills/nisa-cli/SKILL.md

/reload re-scans.

mkdir -p ~/.hermes/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.hermes/skills/nisa-cli/SKILL.md

Hermes also requires a version field: add version: 1.0.0 under name: in the frontmatter.

mkdir -p ~/.agents/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o ~/.agents/skills/nisa-cli/SKILL.md

mkdir -p .agents/skills/nisa-cli
curl -sSL https://api.rapidreview.io/cli/skill -o .agents/skills/nisa-cli/SKILL.md

Replit has no user-level location; run this inside the Repl.

Those are personal paths and cover every project. Project-level variants:

Agent	Personal	Project
Claude Code	`~/.claude/skills/`	`.claude/skills/`
Codex, OpenHands	`~/.agents/skills/`	`.agents/skills/`
Cursor	`~/.cursor/skills/` or `~/.agents/skills/`	`.cursor/skills/` or `.agents/skills/`
Copilot CLI	`~/.copilot/skills/` or `~/.agents/skills/`	`.github/skills/` or `.agents/skills/`
Gemini CLI	`~/.gemini/skills/` or `~/.agents/skills/`	`.gemini/skills/` or `.agents/skills/`
Qwen Code	`~/.qwen/skills/`	`.qwen/skills/`
OpenCode	`~/.config/opencode/skills/`	`.opencode/skills/`
Kilo Code	`~/.kilo/skills/`	`.kilo/skills/`
Hermes Agent	`~/.hermes/skills/`	—
Replit Agent	—	`.agents/skills/`

Then ask the agent something the corpus answers better than memory:

You say

Find three papers from 2024 on speculative decoding and give me the arXiv ids.

It runs nisa search — you’ll see the call in its tool log — and answers with real ids. If it answers from memory, the skill isn’t loading: check the folder name and path.

The skill is public and edge-cached (download: SKILL.md); it doesn’t bundle the binary, so if the agent works in a sandbox, install the CLI there too. The contract between the CLI and an agent — output, concurrency, headless mode, local files — is on Using Nisa from a coding agent.

Manual install

When pipe-to-shell is blocked

If api.rapidreview.io is unreachable, the same installer is at https://storage.googleapis.com/rr_cli_releases/install.sh. To fetch a release archive and its checksum yourself:

VERSION=$(curl -fsSL https://storage.googleapis.com/rr_cli_releases/latest/VERSION)
TARGET=aarch64-apple-darwin
BASE="https://storage.googleapis.com/rr_cli_releases/$VERSION"
curl -fLO "$BASE/nisa-$VERSION-$TARGET.tar.gz"
curl -fLO "$BASE/nisa-$VERSION-$TARGET.tar.gz.sha256"

TARGET is one of aarch64-apple-darwin (Apple Silicon), x86_64-apple-darwin (Intel Mac), x86_64-unknown-linux-musl, aarch64-unknown-linux-musl. Verify the checksum, unpack, and put nisa on your PATH. NISA_VERSION=v0.2.14 pins the scripted installer to a release.

Your first search

Search, open, related, cite.

Troubleshooting

PATH, auth, rate limits, freshness.

Start

Guides

Reference

Keys for scripts and agents

Give your coding agent the skill

Manual install

Your first search

Troubleshooting

​Keys for scripts and agents

​Give your coding agent the skill

​Manual install

Your first search

Troubleshooting

Keys for scripts and agents

Give your coding agent the skill

Manual install