Alpha Research
Researchalpha-researchAlpha Research is an Agent Skill for research published in the companion-inc/feynman repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/companion-inc/feynman/blob/HEAD/skills/alpha-research/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/alpha-research, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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