ruvnet/ruflo는 코딩 에이전트가 실제 업무를 수행하도록 도구, 메모리, 반복 루프, 제어 장치를 덧붙여 주는 '에이전트 하네스'다. README는 "에이전트 = 모델 + 하네스"라는 관점에서 모델은 코드를 쓰고, 하네스가 그 주변 실행 환경을 맡는다고 설명한다. 이 프로젝트는 과거 '클로드 플로(Claude Flow)'로 불렸으며, 제작자 rUv가 이름을 루플로(Ruflo)로 바꿨다.
무엇을 하나
README에 따르면 루플로는 Claude Code와 Codex 위에서 100개 안팎의 전문 에이전트, 협업하는 스웜, 자기학습 메모리, 여러 기기 간 연합(federation) 통신, 엔터프라이즈 보안 가드레일을 제공한다. 사용자는 평소처럼 Claude Code를 쓰고, 훅이 작업을 자동으로 분배·학습한다는 구상이다. 문서상 MCP 도구는 314개, CLI 명령은 26개이지만 모두 익힐 필요는 없다고 안내한다.
작동 방식·구조
큰 흐름은 사용자 → 루플로(CLI/MCP) → 라우터 → 스웜 → 에이전트 → 메모리 → LLM 제공자 순이다. 메모리에 쌓인 경험이 다시 라우팅에 반영된다. README는 이를 개념도일 뿐 실제 실행 추적은 아니라고 선을 긋는다. 벡터 검색과 대조 학습 업데이트는 LLM 없이 로컬에서 돌릴 수 있지만, 임베딩과 학습 모듈 설정은 필요하다고 밝혔다.
플러그인은 35종으로, 스웜·자율 루프·워크플로·벡터 DB·RAG 메모리·보안 감사·프롬프트 인젝션 차단·비용 추적 등으로 나뉜다. 콘솔 플러그인은 워크플로, 에이전트, 모델, 토큰, 비용을 Claude Code 옆에서 보여 주는 '에이전트 조종석' 역할을 한다. Claude가 콘솔을 조작하도록 허용하는 기능도 있는데, 권한은 read·write·manage·full 단계로 나뉜다. 기본값은 읽기+승인 요청이며, 네트워크·비용·파괴적 작업은 자동 모드에서도 확인을 거친다고 설명한다.
써보면
Claude Code 2.1.287 이상에서는 플러그인 마켓플레이스로 설치한다.
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
/ruflo
Codex 등 MCP 지원 도구는 npx ruflo@latest init wizard로 초기 설정하고, 클라이언트에 npx -y ruflo@latest mcp start를 로컬 stdio MCP 서버로 등록한다. 터미널만 쓴다면 npx ruflo tui로 별도 화면도 띄울 수 있다.
의의와 한계
플러그인 방식은 작업 폴더에 파일을 만들지 않는 대신 슬래시 명령과 일부 스킬 중심의 '라이트' 버전이다. 훅, 데몬 등 전체 기능은 npx ruflo init 방식에서 제공된다고 README는 구분한다. 모드(mods)는 사용자 계정 권한으로 샌드박스 없이 실행되므로 설치 전 코드를 검토하라는 경고도 있다. 또 데모 녹화는 샘플 데이터나 렌더러 프레임 재생이라 스웜 작업 완료나 메모리 회상의 증거는 아니라고 스스로 밝히고 있다. 제공된 README 발췌에는 라이선스 정보가 없어 도입 전 확인이 필요하다.
