Feynman CLI

Установка

Работает в

• Codex
• OpenCode

npx skillfoxx add cli/feynman

Что делает

Feynman — консольный агент, который ведет исследование по вопросу или статье и складывает результат в папку проекта. Он работает на открытом агенте Pi и устанавливается пакетом npm. После `feynman setup` вы входите в аккаунт провайдера модели, а дальше запускаете команду с темой, например `feynman lit "RLHF alternatives"`. В интерактивном режиме те же рабочие процессы доступны слэш-командами. Команд десять: `/deepresearch` ведет план и проверку цитат, `/lit` собирает обзор литературы с согласием и спорными местами, `/review` рецензирует статью по степеням важности, `/audit` сверяет заявления статьи с ее публичным кодом, `/replicate` планирует воспроизведение, `/recipe` подбирает рецепты обучения моделей, `/compare` строит матрицу сравнения источников, `/draft` пишет черновик статьи, `/autoresearch` запускает ограниченный цикл экспериментов, `/summarize` пересказывает источник. Поиск идет по alphaXiv, Semantic Scholar, OpenAlex, arXiv, PubMed, Europe PMC, bioRxiv, medRxiv, Crossref, вебу и Hugging Face, а локальные PDF и документы агент читает сам. В работе участвуют четыре агента: исследователь, проверяющий источники, рецензент и автор текста. Для узкого вопроса `/deepresearch` ищет сам за 3–10 вызовов, а для широкой темы подключает от двух до шести исследователей. Затем проверяющий открывает каждую ссылку, а рецензент помечает находки как FATAL, MAJOR или MINOR. Готовый отчет попадает в `outputs/` или `papers/`, рядом лежит файл с происхождением: какие источники использованы, какие отброшены и чем закончилась проверка.

Для кого. Для аспирантов, исследователей и инженеров, которые разбираются в новой теме по статьям, рецензируют чужие работы и проверяют, совпадает ли код репозитория с тем, что заявлено в статье.

Пример запроса к агенту

Сделай обзор литературы по альтернативам RLHF за последние два года, отметь, где авторы спорят, и сохрани отчет с ссылками

Ограничения

• Лицензия MIT. Для работы нужна модель: Feynman не включает свою, ключ или вход в аккаунт провайдера вы задаете сами. Ключи `OPENALEX_API_KEY` и `SEMANTIC_SCHOLAR_API_KEY` бесплатные, но без них общие лимиты поиска ниже, а `NCBI_API_KEY` поднимает лимит запросов к PubMed с 3 до 10 в секунду.
• По умолчанию включена телеметрия в PostHog: команды, рабочие процессы, инструменты, модели, число токенов и ошибки с текстом и стеком, где домашняя папка заменена на `~`. Промпты, ответы модели, содержимое статей и аргументы инструментов не уходят. Отключается переменной `FEYNMAN_TELEMETRY=off`.
• Команды `/replicate` и `/autoresearch` выполняют код. Среду (локально, виртуальное окружение, Docker, Modal или RunPod) агент спрашивает до запуска, а для Modal и RunPod нужны свои аккаунты и ключи. Цикл экспериментов по умолчанию ограничен 20 итерациями.
• Пакет со скиллами из `scripts/install/install-skills.sh` ставит шестнадцать скиллов и тексты команд. Сами скиллы короткие: они вызывают рабочие процессы Feynman, а без самого агента не заменяют его.
• В репозитории лежат результаты оценки обзоров литературы от 23 и 24 сентября 2026 года для нескольких моделей. Это замеры автора, а не гарантия качества на вашей теме, и каждый вывод агента стоит перепроверять по ссылкам.

Как отключить. Удалите пакет командой `npm uninstall -g @companion-ai/feynman`. Если вы ставили агента скриптом, порядок удаления описан в руководстве по установке на сайте проекта. Пакет со скиллами лежит в папке `skills/feynman` внутри `$CODEX_HOME`, `.agents/skills` или `.opencode/skills`, и вы убираете его, удалив эту папку. Отчеты остаются в папках `outputs/` и `papers/` вашего проекта.

Коротко о README

В репозитории лежат исходный код агента на TypeScript, четыре описания агентов, десять текстов рабочих процессов, шестнадцать скиллов и расширение с поиском по научным базам. Есть тесты, сценарии сборки и проверки пакета с ограничением размера, проверка происхождения публикации в npm и каталог оценок: вопросы и результаты прогонов нескольких моделей. Для установки приложены скрипты под macOS, Linux и Windows, а документация вынесена на сайт проекта.