a452cd95b8
- Every workflow prompt now shows a plan and asks the user to confirm before executing - /autoresearch asks for execution environment (local, branch, venv, cloud) and confirms before looping - Writer agent and key prompts now generate charts (pi-charts) and diagrams (Mermaid) when data calls for it - Cite alphaXiv and Agent Computer in README and website homepage - Clear terminal screen before launching Pi TUI - Remove Alpha Hub GitHub link in favor of alphaxiv.org Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Feynman
The open source AI research agent
npm install -g @companion-ai/feynman
feynman setup
feynman
What you type → what happens
| Prompt | Result |
|---|---|
feynman "what do we know about scaling laws" |
Searches papers and web, produces a cited research brief |
feynman deepresearch "mechanistic interpretability" |
Multi-agent investigation with parallel researchers, synthesis, verification |
feynman lit "RLHF alternatives" |
Literature review with consensus, disagreements, open questions |
feynman audit 2401.12345 |
Compares paper claims against the public codebase |
feynman replicate "chain-of-thought improves math" |
Asks where to run, then builds a replication plan |
feynman "summarize this PDF" --prompt paper.pdf |
One-shot mode, no REPL |
Workflows
Ask naturally or use slash commands as shortcuts.
| Command | What it does |
|---|---|
/deepresearch <topic> |
Source-heavy multi-agent investigation |
/lit <topic> |
Literature review from paper search and primary sources |
/review <artifact> |
Simulated peer review with severity and revision plan |
/audit <item> |
Paper vs. codebase mismatch audit |
/replicate <paper> |
Replication plan with environment selection |
/compare <topic> |
Source comparison matrix |
/draft <topic> |
Paper-style draft from research findings |
/autoresearch <idea> |
Autonomous experiment loop |
/watch <topic> |
Recurring research watch |
Agents
Four bundled research agents, dispatched automatically or via subagent commands.
- Researcher — gather evidence across papers, web, repos, docs
- Reviewer — simulated peer review with severity-graded feedback
- Writer — structured drafts from research notes
- Verifier — inline citations, source URL verification, dead link cleanup
Tools
- AlphaXiv — paper search, Q&A, code reading, persistent annotations
- Agent Computer — secure cloud execution for experiments, replications, and long-running research
- Web search — Gemini or Perplexity, zero-config default via signed-in Chromium
- Session search — indexed recall across prior research sessions
- Preview — browser and PDF export of generated artifacts
CLI
feynman # REPL
feynman setup # guided setup
feynman doctor # diagnose everything
feynman status # current config summary
feynman model login [provider] # model auth
feynman model set <provider/model> # set default model
feynman alpha login # alphaXiv auth
feynman search status # web search config
How it works
Built on Pi, alphaXiv, and Agent Computer. Pi provides the agent runtime. alphaXiv powers paper search, Q&A, code reading, and annotations. Agent Computer provides secure cloud machines for running experiments and replications.
Every output is source-grounded. Claims link to papers, docs, or repos with direct URLs.
Contributing
git clone https://github.com/getcompanion-ai/feynman.git
cd feynman && npm install && npm run start
Built on Pi, alphaXiv, and Agent Computer.