Scholar Inbox Skill
All commands support --json for machine-readable output.
Setup
./scripts/setup_env.sh # install into local .venv
.venv/bin/scholarinboxcli # use the CLI
# or install globally
uv tool install git+https://github.com/zhjcreator/scholarinboxcli.git
Authentication
# Method 1: Set env var — login without any flag (fork only)
export SCHOLAR_INBOX_SHA_KEY="YOUR_SHA_KEY"
scholarinboxcli auth login
# Method 2: Pass sha_key via flag (fork only)
scholarinboxcli auth login --sha-key "YOUR_SHA_KEY"
# Method 3: Full magic-link URL (original CLI)
scholarinboxcli auth login --url "https://www.scholar-inbox.com/login?sha_key=...&date=MM-DD-YYYY"
scholarinboxcli auth status # check session
scholarinboxcli auth logout # clear session
> Get sha_key: Log in at https://www.scholar-inbox.com, open DevTools (F12) → Network → find api/session_info request → copy sha_key from response.
Daily Digest
scholarinboxcli digest --json # today's digest
scholarinboxcli digest --date 04-01-2026 # specific date (MM-DD-YYYY)
Trending Papers
scholarinboxcli trending --json # default: ALL, 7 days
scholarinboxcli trending --category "Machine Learning" --days 30
scholarinboxcli trending --sort hype --json # sort by hype (default)
scholarinboxcli trending --sort citations --asc --json
Categories: ALL, Language, Machine Learning, Computer Vision and Graphics, Artificial Intelligence, Robotics, Sound and Audio Processing, Interdisciplinary.
Search
scholarinboxcli search "transformers" --limit 10 --json
scholarinboxcli search "LLM" --limit 5 --offset 10 # pagination
scholarinboxcli semantic "graph neural networks" --limit 5 --json # semantic
scholarinboxcli semantic --file query.txt --json # query from file
Semantic results include a similarity field (0-100).
Rate Papers
Requires the fork (zhjcreator/scholarinboxcli):
scholarinboxcli rate PAPER_ID 1 # upvote
scholarinboxcli rate PAPER_ID -1 # downvote
scholarinboxcli rate PAPER_ID 0 # remove rating
Get PAPER_ID from the _id field in any search/digest/trending result.
Bookmarks
scholarinboxcli bookmark list --json
scholarinboxcli bookmark add PAPER_ID
scholarinboxcli bookmark remove PAPER_ID
Collections
scholarinboxcli collection list --json
scholarinboxcli collection create "My Papers"
scholarinboxcli collection papers "My Papers" --json
scholarinboxcli collection add "My Papers" PAPER_ID
scholarinboxcli collection remove "My Papers" PAPER_ID
scholarinboxcli collection rename "Old" "New"
scholarinboxcli collection delete "My Papers"
scholarinboxcli collection similar "My Papers" --json # recommendations
Conferences & Interactions
scholarinboxcli conference list --json
scholarinboxcli conference explore --json
scholarinboxcli interactions --json # your view/like/dislike history
Output Fields
When presenting papers from --json, key fields:
| Field | Path | Description |
|---|---|---|
| Title | title |
Paper title |
| Authors | authors |
Author list |
| Date | publication_date |
YYYY-MM-DD |
| Venue | display_venue |
e.g., "NeurIPS 2022" |
| Abstract | abstract |
Full abstract |
| PDF Link | url |
arxiv.org/pdf/... |
| Citations | citations |
Citation count |
| Likes | total_likes |
Platform likes |
| Reads | total_read |
Platform reads |
| Paper ID | _id |
Unique ID (for rating) |
| Similarity | similarity |
Semantic search only (0-100) |
Full schema: references/json-response-schema.md
Troubleshooting
- "command not found": Run
./scripts/setup_env.sh - Auth errors: Re-login:
scholarinboxcli auth login --url "..." - "uv not found":
brew install uvorcurl -LsSf https://astral.sh/uv/install.sh | sh
