Feynman CLI + Portable Agent Skill

Research.
Citations.
No Fake Sources.

공식 Feynman CLI 설치와 ChatGPT/Codex OAuth 연결을 한 번에 정리하고, Codex · Antigravity · Claude Code · Cursor에서 같은 research workflow를 쓰도록 만든 범용 Agent Skill Kit.

Source-grounded research · 15 workflow refs · 4 role agents · AGENTS/CLAUDE/GEMINI/Cursor adapters

1. Feynman CLI Install

macOS / Linux

curl -fsSL https://feynman.is/install | bash

Windows PowerShell

irm https://feynman.is/install.ps1 | iex

Node/npm Alternative

npm install -g @companion-ai/feynman

Node >=20.19.0 <25 필요. 공식 README의 기본 경로는 standalone installer.

Check

feynman --version
feynman setup
feynman doctor
feynman status

2. ChatGPT / Codex OAuth

API key가 아니라 ChatGPT/Codex 구독 OAuth를 쓰려면 provider가 openai-codex여야 합니다.

feynman model login openai-codex
feynman model set openai-codex/gpt-5.4
feynman model list
feynman status

Redirect URL 입력: 브라우저 콜백 자동 수신이 안 되면 Paste redirect URL or auth code 칸에 http://localhost:1455/auth/callback?code=...&state=... 전체 URL을 넣는 게 가장 안전합니다.

GPT-5.5: Feynman CLI 0.2.40 기준 current/recommended는 openai-codex/gpt-5.4. Upstream Pi 0.70.6에는 gpt-5.5 카탈로그가 들어왔으므로 Feynman 새 릴리스가 노출하면 교체 가능합니다.

3. Universal Agent Adapters

핵심 workflow는 skills/feynman/SKILL.md 한 곳에 두고, 각 도구가 읽는 얇은 어댑터만 추가합니다.

Codex

AGENTS.md가 Codex의 project instruction entrypoint입니다.

cp AGENTS.md /path/to/project/
cp -R skills/feynman /path/to/project/skills/

Antigravity

AGENTS.md를 공통 규칙으로 두고 GEMINI.md에 Antigravity-specific reminder를 둡니다.

cp AGENTS.md GEMINI.md /path/to/project/
cp -R skills/feynman /path/to/project/skills/

Claude Code

개인 또는 프로젝트 skill 경로에 그대로 복사합니다. custom agents는 선택 사항입니다.

mkdir -p ~/.claude/skills ~/.claude/agents
cp -R skills/feynman ~/.claude/skills/
cp agents/feynman-*.md ~/.claude/agents/

Cursor

.cursor/rules에 project rule을 두고 AGENTS.md를 fallback으로 유지합니다.

mkdir -p /path/to/project/.cursor/rules
cp .cursor/rules/feynman-research.mdc /path/to/project/.cursor/rules/
cp AGENTS.md /path/to/project/

한 번에 다른 프로젝트로 옮기는 전체 명령은 Universal Agent Setup에 정리했습니다.

4. Feynman Subskill Catalog

4개 role agent는 실행 역할이고, 실제 workflow는 아래 subskill/ref 파일들이 담당합니다.

Subskill	Use when	Command	CLI
`literature-review`	논문·문서·repo 기반 문헌 검토와 URL-grounded overview.	`/feynman literature-review <topic>`	`feynman lit`
`deep-research`	다수 논문/웹/문서에 걸친 장시간 심층 리서치.	`/feynman deep-research <topic>`	`feynman deepresearch`
`paper-writing`	검증된 research notes를 논문·리포트·긴 초안으로 변환.	`/feynman paper-writing <topic>`	`feynman draft`
`peer-review`	산출물을 FATAL / MAJOR / MINOR 기준으로 비판 검토.	`/feynman peer-review <artifact>`	`feynman review`
`source-comparison`	여러 출처의 주장·방법·결과를 비교하고 충돌 지점 정리.	`/feynman source-comparison <sources>`	`feynman compare`
`paper-code-audit`	논문과 repo/benchmark 구현의 일치 여부를 감사.	`/feynman paper-code-audit <paper+repo>`	`feynman audit`
`alpha-research`	alphaXiv식 논문 토론·관련 연구 탐색.	`/feynman alpha-research <query>`	`alpha`
`summarize`	단일 논문, URL, markdown, source bundle 요약.	`/feynman summarize <source>`	`feynman summarize`
`replicate`	논문/실험의 재현 계획과 필요한 artifact 정리.	`/feynman replicate <paper>`	`feynman replicate`
`autoresearch`	아이디어에서 가설, source sweep, 다음 실험까지 반복.	`/feynman autoresearch <idea>`	`feynman autoresearch`
`watch`	주제 감시 쿼리와 반복 리서치 루틴 생성.	`/feynman watch <topic>`	`feynman watch`
`jobs`	진행/완료된 research output과 blocked state 점검.	`/feynman jobs`	status review
`eli5`	복잡한 개념을 쉬운 설명으로 바꾸되 caveat 유지.	`/feynman eli5 <concept>`	inline
`visualization`	표·그림·다이어그램을 provenance와 함께 설계.	other workflows reference it	internal
`cli-handoff`	대형 작업을 Pi/Feynman CLI로 넘기고 산출물을 회수.	`/feynman cli-handoff <subcmd>`	subprocess

5. Four-Agent Pipeline

feynman-researcher

논문, 웹, repo, docs에서 URL-grounded evidence 수집.

Evidence

feynman-writer

research notes를 초안으로 변환. citation은 붙이지 않음.

Draft

feynman-verifier

inline citation, URL verification, Sources, provenance audit.

Gate

feynman-reviewer

FATAL / MAJOR / MINOR 관점의 skeptical peer review.

Review

6. Optional Vault Handoff

feynman-to-vault.sh는 Feynman CLI 산출물과 figures를 로컬 vault 폴더로 복사하고 이미지 링크를 재기입합니다.

export FEYNMAN_VAULT_DIR="/path/to/your/vault/10_Raw/07_Scholar"
~/.claude/skills/feynman/bin/feynman-to-vault.sh <md_path> <slug>

스크립트는 기계적 복사만 담당합니다. 이후 활성 에이전트가 frontmatter, callout, provenance sidecar를 붙이는 구조입니다.

Integrity Rules

URL or it didn't happen

직접 접근 가능한 URL 없이는 근거로 채택하지 않습니다.

Never fabricate sources

존재 미확인 논문, repo, 도구, benchmark를 만들지 않습니다.

No fake certainty

검증하지 않은 것을 verified/confirmed/reproduced라고 쓰지 않습니다.

Result provenance

수치, 표, 그림, benchmark는 source 또는 artifact path와 매핑합니다.

Research.Citations.No Fake Sources.