Alpha Research CLI

SkillSearch

Lets your agent search, read, ask questions about, and annotate academic papers.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Alpha Research CLI skill

About this capability

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.

What this skill tells your AI

The instructions your AI receives, as published by companion-inc/feynman in skills/alpha-research/SKILL.md and read by ahel’s review.

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

CommandDescription
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 --listList 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

Signals

GitHub stars
9k
Forks
1k
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
alpha-research
Source
github.com/companion-inc/feynman