Files

Advait Paliwal f5570b4e5a Rename .pi to .feynman, rename citation agent to verifier, add website, skills, and docs

- Rename project config dir from .pi/ to .feynman/ (Pi supports this via piConfig.configDir)
- Rename citation agent to verifier across all prompts, agents, skills, and docs
- Add website with homepage and 24 doc pages (Astro + Tailwind)
- Add skills for all workflows (deep-research, lit, review, audit, replicate, compare, draft, autoresearch, watch, jobs, session-log, agentcomputer)
- Add Pi-native prompt frontmatter (args, section, topLevelCli) and read at runtime
- Remove sync-docs generation layer — docs are standalone
- Remove metadata/prompts.mjs and metadata/packages.mjs — not needed at runtime
- Rewrite README and homepage copy
- Add environment selection to /replicate before executing
- Add prompts/delegate.md and AGENTS.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-23 17:35:35 -07:00

3.4 KiB

Raw Blame History

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
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 and Alpha Hub. Pi provides the agent runtime — file access, shell execution, persistent sessions, custom extensions. Alpha Hub connects to alphaXiv for paper search, Q&A, code reading, and annotations.

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

Docs · MIT License

Built on Pi and Alpha Hub.

3.4 KiB Raw Blame History