Quick Start

This guide assumes you have already installed Feynman and run feynman setup. If not, start there first.

Launch the REPL

Start an interactive session by running:

feynman

You are dropped into a conversational REPL where you can ask research questions, run workflows, and interact with agents in natural language. Type your question and press Enter.

Run a one-shot prompt

If you want a quick answer without entering the REPL, use the --prompt flag:

feynman --prompt "Summarize the key findings of Attention Is All You Need"

Feynman processes the prompt, prints the response, and exits. This is useful for scripting or piping output into other tools.

Start a deep research session

Deep research is the flagship workflow. It dispatches multiple agents to search, read, cross-reference, and synthesize information from academic papers and the web:

feynman
> /deepresearch What are the current approaches to mechanistic interpretability in LLMs?

The agents collaborate to produce a structured research report with citations, key findings, and open questions. The full report is saved to your session directory for later reference.

Work with files

Feynman can read and write files in your working directory. Point it at a paper or codebase for targeted analysis:

feynman --cwd ~/papers
> /review arxiv:2301.07041

You can also ask Feynman to draft documents, audit code, or compare multiple sources by referencing local files directly in your prompts.

Explore slash commands

Type /help inside the REPL to see all available slash commands. Each command maps to a workflow or utility, such as /deepresearch, /review, /draft, /watch, and more. You can also run any workflow directly from the CLI:

feynman deepresearch "transformer architectures for protein folding"

See the Slash Commands reference for the complete list.