원문 캡처 · github.com
원문 캡처 · github.com

Reflex는 Claude Code, Codex, Cursor의 작업 기록을 살펴 여러 세션에서 반복된 워크플로를 재사용 가능한 SKILL.md로 만드는 오픈소스 터미널 도구다. 기록은 로컬에서 처리하며, 같은 종류의 작업이 서로 독립적인 세션 3개 이상에서 확인돼야 제안한다. 사용자가 검토하고 승인한 뒤에만 스킬을 설치한다.

Node.js 22.13 이상이 필요하다. 설치와 기본 사용 절차는 다음과 같다.

text
npm install -g reflex-skills # installs the `reflex` command (the npm name `reflex` is a different package)
reflex doctor # what Reflex can see, without reading anything
reflex scan --days 30 # read your Claude Code / Codex / Cursor history (asks first)
reflex suggest # review suggestions: [a]pprove, [e]vidence, [r]eject
reflex install <name> # copy a skill into Claude Code, Codex and/or Cursor (asks per target)

scan은 먼저 확인을 요청하고, 변경되지 않은 기록은 다시 열지 않는다. 개인정보와 비밀 정보, 홈 디렉터리 경로, 사용자 이름은 저장하거나 표시하기 전에 가린다. Reflex는 기록을 지시가 아닌 데이터로 취급하며, 선택형 임베딩 모델을 내려받을 때를 제외하면 네트워크에 연결하지 않는다고 프로젝트는 설명한다. 임베딩 모델은 선택 사항이며, 내려받은 뒤에는 로컬에서 실행된다.

스킬에는 세션 절반 이상에서 확인된 단계와 안전 필터를 통과한 반복 명령만 들어간다. 원본 대화 인용은 포함하지 않는다. 같은 수정 요청이 서로 다른 세션 2개 이상에서 반복되면 스킬의 제약 조건에 반영한다. 제안의 근거가 되는 기록과 불확실성은 따로 확인할 수 있다.

기록 분석은 Claude Code, Codex, Cursor를 지원하지만 검증 상태와 수집 가능한 정보는 다르다. Codex 파서는 테스트용 사례로 검증됐지만 실제 기록이나 실행 중인 Codex 세션에서는 아직 시험되지 않았다. Cursor 기록에는 도구 실행 결과가 없어 성공·실패 여부를 알 수 없고, 토큰도 기록되지 않는다. 각 기록 출처에서 스캔당 최근 파일 최대 2,000개를 읽는다.

작업 기록에서 반복 패턴을 찾는 기준은 확률이 아니라 순위를 매기는 휴리스틱이다. 임베딩 모델을 쓰지 않으면 서로 다른 언어로 쓰였거나 공통 단어가 없는 요청은 매칭에 어려움이 있을 수 있다. Reflex는 저장소에서 설치와 사용법, 보안 위협 모델을 안내한다.