ONEDEV

ruflo

AI Agent OrchestrationskillTypeScript

★ 72,579주당 +591조회 6

무엇인가

Ruflo는 Claude Code·Codex 위에 얹히는 에이전트 메타 하네스로, 모델 호출 자체가 아니라 그 주변의 실행 규율을 담당한다. 작업 라우팅, 스웜 편성, 세션 간 기억, 머신 간 페더레이션 통신, 보안 가드레일을 규칙과 도구로 고정해, 에이전트가 단일 응답 생성기가 아니라 협업 단위로 동작하도록 제약한다.

어떻게 동작하나

동작은 세 층으로 나뉜다. 설치 시 등록되는 MCP 서버가 도구 호출 표면을 제공하고, 훅 시스템이 사용자 요청을 가로채 적합한 에이전트·스웜으로 라우팅하며, 메모리 계층이 성공 패턴을 저장해 다음 세션에 재사용한다. 플러그인 경로로 설치한 ruflo-core는 자체 MCP 서버를 등록하며 도구가 mcp__plugin_ruflo-core_ruflo__memory_store 형태의 이름으로 노출된다. CLI 경로는 memory_store·swarm_init·agent_spawn 같은 짧은 이름을 쓴다.

무엇과 다른가

CLAUDE.md·AGENTS.md에 규칙 문장을 직접 적는 방식과 달리, Ruflo는 정적 텍스트가 아니라 실행 계층이다. 규칙 파일은 에이전트가 읽는 지침에 머무르지만, 여기서는 MCP 도구·훅·메모리 백엔드·플러그인 마켓플레이스가 함께 배포되어 라우팅과 기억이 런타임에 강제된다. 프롬프트를 매번 다시 쓰거나 에이전트 정의를 수동으로 복사할 필요가 없다.

어떻게 쓰나

설치는 두 경로다. 플러그인 경로는 /plugin marketplace add ruvnet/ruflo 후 ruflo-core·ruflo-swarm·ruflo-rag-memory 같은 플러그인을 골라 설치하며 슬래시 명령과 에이전트 정의를 추가한다. CLI 경로는 npx ruflo@latest init wizard 또는 npm install -g ruflo@latest로 초기화하고, claude mcp add claude-flow -- npx ruflo@latest mcp start로 MCP 서버를 등록한다. 초기화 후에는 평소처럼 Claude Code를 쓰면 훅이 백그라운드에서 라우팅과 학습을 처리한다.

전제와 한계

지원 대상은 Claude Code가 중심이고 Codex도 함께 명시된다. Windows에서는 curl | bash 형태가 POSIX 셸(Git-Bash·WSL·MSYS)을 요구하므로 npx ruflo@latest init wizard를 써야 한다. 플러그인 경로와 CLI 경로는 도구 이름 체계가 달라 같은 MCP 도구를 그대로 옮겨 쓸 수 없고, 웹 UI는 베타이며 페더레이션의 WireGuard 메시 계층은 선택 사항이다.

관련 논문 5

유사 도구