43 lines
1.8 KiB
Markdown
43 lines
1.8 KiB
Markdown
---
|
|
name: alpha-research
|
|
description: 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.
|
|
---
|
|
|
|
# Alpha Research CLI
|
|
|
|
Use the `alpha` CLI via bash for all paper research operations.
|
|
|
|
## Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `alpha search "<query>"` | Search papers. Prefer `--mode semantic` by default; use `--mode keyword` only for exact-term lookup and `--mode agentic` for broader retrieval. |
|
|
| `alpha get <arxiv-id-or-url>` | Fetch paper content and any local annotation |
|
|
| `alpha get --full-text <arxiv-id>` | Get raw full text instead of AI report |
|
|
| `alpha ask <arxiv-id> "<question>"` | Ask a question about a paper's PDF |
|
|
| `alpha code <github-url> [path]` | Read files from a paper's GitHub repo. Use `/` for overview |
|
|
| `alpha annotate <paper-id> "<note>"` | Save a persistent annotation on a paper |
|
|
| `alpha annotate --clear <paper-id>` | Remove an annotation |
|
|
| `alpha annotate --list` | List all annotations |
|
|
|
|
## Auth
|
|
|
|
Run `alpha login` to authenticate with alphaXiv. Check status with `feynman alpha status`, or `alpha status` once your installed `alpha-hub` version includes it.
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
alpha search "transformer scaling laws"
|
|
alpha search --mode agentic "efficient attention mechanisms for long context"
|
|
alpha get 2106.09685
|
|
alpha ask 2106.09685 "What optimizer did they use?"
|
|
alpha code https://github.com/karpathy/nanoGPT src/model.py
|
|
alpha annotate 2106.09685 "Key paper on LoRA - revisit for adapter comparison"
|
|
```
|
|
|
|
## When to use
|
|
|
|
- Academic paper search, reading, Q&A → `alpha`
|
|
- Current topics (products, releases, docs) → web search tools
|
|
- Mixed topics → combine both
|