alpha-research

star 7.9k

Search, read, and query research papers via the `alpha` CLI (alphaXiv-backed). Use when the user asks about academic papers, wants to find research on a topic, needs to read a specific paper, ask questions about a paper, inspect a paper's code repository, or manage paper annotations.

companion-inc By companion-inc schedule Updated 3/25/2026

name: alpha-research description: Search, read, and query research papers via Feynman's alphaXiv-backed alpha tools. Use when the user asks about academic papers, wants to find research on a topic, needs to read a specific paper, ask questions about a paper, inspect a paper's code repository, or manage paper annotations.

Alpha Research CLI

Use visible Feynman alpha tools when they are available. For shell commands, use feynman alpha ...; do not call the user's bare global alpha binary because it can be stale or unpatched.

Commands

Command Description
feynman alpha search "<query>" Search papers. Prefer --mode semantic by default; use --mode keyword only for exact-term lookup and --mode agentic for broader retrieval.
feynman alpha get <arxiv-id-or-url> Fetch paper content and any local annotation
feynman alpha get --full-text <arxiv-id> Get raw full text instead of AI report
feynman alpha ask <arxiv-id> "<question>" Ask a question about a paper's PDF
feynman alpha code <github-url> [path] Read files from a paper's GitHub repo. Use / for overview
feynman alpha annotate <paper-id> "<note>" Save a persistent annotation on a paper
feynman alpha annotate --clear <paper-id> Remove an annotation
feynman alpha annotate --list List all annotations

Auth

Run feynman alpha login to authenticate with alphaXiv. Check status with feynman alpha status.

Examples

feynman alpha search "transformer scaling laws"
feynman alpha search --mode agentic "efficient attention mechanisms for long context"
feynman alpha get 2106.09685
feynman alpha ask 2106.09685 "What optimizer did they use?"
feynman alpha code https://github.com/karpathy/nanoGPT src/model.py
feynman alpha annotate 2106.09685 "Key paper on LoRA - revisit for adapter comparison"

When to use

  • Academic paper search, reading, Q&A → Feynman alpha tools or feynman alpha
  • Current topics (products, releases, docs) → web search tools
  • Mixed topics → combine both
Install via CLI
npx skills add https://github.com/companion-inc/feynman --skill alpha-research
Repository Details
star Stars 7,868
call_split Forks 948
navigation Branch main
article Path SKILL.md
More from Creator
companion-inc
companion-inc Explore all skills →