ruvnet/ruflo — 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Ruflo, Claude Code와 Codex를 위한 에이전트 오케스트레이션 도구
Ruflo는 Claude Code와 Codex에 MCP 서버, 에이전트 조정, 메모리와 플러그인을 더하는 에이전트 하네스입니다. 저장소는 두 가지 설치 경로와 보안·학습·연합 기능을 안내하지만, 데모가 실제 스웜 작업이나 메모리 회수를 입증하지는 않는다고 밝힙니다.
- 주제
에디터 노트
Ruflo의 기능 범위는 넓지만, 저장소가 제시한 데모만으로 스웜의 작업 성과나 세션 간 기억을 확인할 수는 없습니다. 저장소 스스로 미션 생성은 구현 완료를 뜻하지 않고, 애니메이션도 실제 스웜 작업이나 메모리 회수의 증거가 아니라고 구분합니다. 이 제한은 제품 설명과 시연에서 확인 가능한 범위를 가르는 데 도움이 됩니다. 반면 HNSW 메모리의 비교 수치에는 데이터 크기와 recall@10이 제시되고, 작은 데이터에서는 성능 이득이 없을 수 있다는 조건도 붙습니다. 전체 벤치마크에는 재현 자료 링크가 있다고 하지만, 본문만으로는 다른 기능의 성능이나 보안 주장을 같은 수준으로 검증하기 어렵습니다. 특히 플러그인 모드는 계정 권한으로 실행되고 샌드박스가 아니므로, 권한 설정과 코드 검토가 설치 판단의 구체적인 기준입니다.
AI 요약
Ruflo는 모델이 도구와 메모리, 실행 루프, 제어 기능을 이용해 작업하도록 연결하는 하네스입니다. 저장소는 Claude Code와 Codex를 비롯한 MCP 지원 클라이언트에 에이전트 조정 기능을 제공한다고 설명합니다. Claude Code 플러그인으로 일부 기능을 골라 쓰거나, CLI를 설치해 MCP 서버와 훅, 에이전트, 명령, 스킬을 포함한 전체 실행 환경을 구성할 수 있습니다.
설치 경로와 구성
Claude Code 플러그인 설치에는 2.1.287 이상이 필요합니다. ruflo-core는 기반 도구를 제공하고 ruflo-console은 터미널 콘솔을 열며 ruflo-mods는 프롬프트 라우팅과 정책 적용을 담당합니다. 플러그인 경로는 작업 공간에 파일을 추가하지 않지만, CLI 경로는 .claude/, .claude-flow/, CLAUDE.md, 설정 파일과 헬퍼를 설치하고 MCP 서버와 훅을 등록합니다. 저장소는 전체 기능을 사용하려면 npx ruflo@latest init wizard로 CLI를 초기화하라고 안내합니다. Codex 등 MCP 클라이언트는 npx -y ruflo@latest mcp start를 로컬 stdio 서버로 연결합니다. 터미널 콘솔은 Claude Code 없이 npx ruflo tui로 실행할 수도 있습니다.
에이전트 조정과 메모리
저장소가 제시한 구조는 CLI 또는 MCP에서 라우터, 스웜, 에이전트, 메모리, LLM 제공자로 이어집니다. 계층형·메시·적응형 토폴로지와 합의 방식을 지원하고, 에이전트가 과거 작업에서 얻은 경험을 메모리에 저장해 라우팅에 반영한다는 설명입니다. 기능 목록에는 100개 이상의 전문 에이전트, 12개 자동 실행 백그라운드 워커, Claude·GPT·Gemini·Cohere·Ollama 지원이 포함됩니다. HNSW 인덱스를 사용하는 벡터 메모리는 N=20,000에서 무차별 탐색보다 약 1.9배, N=5,000에서 약 3.2~4.7배 빠르며 recall@10은 약 0.99라고 저장소가 보고합니다. 작은 데이터에서는 근사 최근접 탐색의 이득이 없거나 무차별 탐색보다 느릴 수 있다는 조건도 함께 적었습니다. 학습 결과는 메모리와 학습 모듈 설정, 피드백 품질에 좌우된다고 설명합니다.
연합과 보안
Federation 기능은 서로 다른 컴퓨터나 조직의 에이전트를 연결하는 구성입니다. 저장소는 mTLS와 ed25519 챌린지 응답으로 상대 신원을 확인하고, 외부로 나가는 메시지를 14종 PII 탐지 파이프라인으로 검사한다고 설명합니다. 신뢰 수준에 따라 정보를 차단하거나 가리고, 해시 처리하거나 통과시키는 정책을 적용합니다. 성공률, 가동 시간, 위협, 무결성을 반영해 상대 신뢰도를 갱신하며, 신뢰 수준이 낮은 에이전트에는 발견 정보만 공개한다는 설명도 있습니다. 다만 이 기능 설명은 저장소가 제시한 설계와 구현 안내입니다.
콘솔과 데모의 범위
콘솔은 워크플로, 에이전트, 모델, 토큰 사용량과 비용을 보여주며 실행 로그 검색, 실패 분류, 재생과 비교 기능을 제공합니다. Claude가 콘솔을 조작하도록 허용할 때는 읽기·쓰기·관리·전체 권한을 고르고 승인 방식을 설정합니다. 기본값은 읽기와 요청 후 승인입니다. 저장소는 플러그인 모드가 사용자 계정 권한으로 실행되며 샌드박스가 아니므로 설치 전 코드를 검토하라고 명시합니다. 시연 영상은 미션 생성과 화면 이동 등을 보여주지만, 미션 생성이 기능 구현을 뜻하지는 않는다고 설명합니다. 워크플로 애니메이션은 샘플 데이터를 사용하며 테마 데모는 렌더러 프레임을 재생합니다. 어느 데모도 실제 스웜 작업 완료나 메모리 회수를 입증하지 않는다고 밝힙니다.
원문: GitHub / 번역·요약: Trawling