ruflo

Claude Code와 Codex를 위한 에이전트 메타 하네스입니다.

Ruflo 시작하기
핵심 도구, 비주얼 콘솔, 런타임 모드로 Claude Code에서 시작하세요. Claude Code 2.1.287 이상이 필요합니다. Claude Code 안에서 실행하세요:

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
/ruflo

Core는 기반 도구를 제공합니다. Console은 에이전트 콕핏을 엽니다. Mods는 Claude Code 내부에서 라우팅과 정책 적용을 추가합니다. Mods는 계정 권한으로 실행되므로 설치 전에 코드를 검토하세요.

Codex나 다른 MCP 지원 도구를 사용하시나요? Ruflo 프로젝트 설정에는 NPX를 사용하고 클라이언트를 Ruflo MCP 서버에 연결하세요. 프로젝트 터미널에서 설정 마법사를 실행하세요:

npx ruflo@latest init wizard
로컬 stdio MCP 서버를 지원하는 클라이언트의 경우 command를 npx로, arguments를 ["-y", "ruflo@latest", "mcp", "start"]로 설정하세요. 동등한 서버 명령은 다음과 같습니다:

npx -y ruflo@latest mcp start
MCP는 Ruflo 도구를 클라이언트에 노출합니다. 위의 콘솔과 mods는 Claude Code 통합이며, 훅 지원은 클라이언트에 따라 다릅니다.

일반 터미널을 선호하시나요? 선택 사항입니다. 콘솔은 Claude Code 없이도 단독으로 실행됩니다: npx ruflo tui (스크립트용으로 한 프레임을 출력하려면 --plain 추가). Overview, Cost, Swarm, Events, Missions와 선택적 AI 페이지를 보여줍니다. 터미널 UI 가이드

설치 경로 비교 · 콘솔 열기 · 사용자 가이드

선택 사항: ruOS Desktop

MCP를 통해 ruOS를 ChatGPT 또는 Claude에 연결:

https://ruos.cognitum.one/mcp

npx ruvector
Ruflo
English · 简体中文

📖 RuFlo 설명 — 계획하고, 기억하고, 테스트하고, 개선하는 AI 팀 구축하기
14개 챕터 가이드: 기본 개념에서 첫 번째 유용한 작업까지, 그다음 메모리, 에이전트 팀, 플러그인, 비용과 검증.

Agent = Model + Harness. 모델은 글을 쓰고, 하네스는 도구, 메모리, 루프, 샌드박스, 제어를 제공하여 실제로 작업할 수 있게 합니다. Ruflo는 하네스입니다 — Claude Code와 Codex를 둘러싼 실행 계층으로, 100개 이상의 특화된 에이전트, 조율된 스웜, 자기 학습 메모리, 머신 간 연합 통신, 엔터프라이즈 보안 가드레일을 추가합니다. 그래서 에이전트는 단순히 실행되는 것이 아니라 협업합니다.

npx ruflo init 한 번으로 Claude Code에 신경계가 생깁니다: 에이전트는 스웜으로 자기 조직화하고, 모든 작업에서 학습하며, 세션을 넘어 기억하고 — 연합을 통해 — 데이터 유출 없이 다른 머신의 에이전트와 안전하게 대화합니다. 여러분은 계속 코드를 작성하세요. Ruflo가 조율을 처리합니다.

개념적 학습 루프. 로컬 벡터 검색과 대조 학습은 LLM 없이 실행될 수 있지만, 임베딩과 구성된 학습 모듈은 여전히 필요합니다. RuVector 학습 통합과 궤적 대조 학습을 참고하세요.

텍스트로 본 아키텍처
User → Ruflo (CLI/MCP) → Router → Swarm → Agents → Memory → LLM providers. 메모리는 유용한 경험을 라우팅으로 다시 공급합니다. 이는 개념적 흐름이며 실제 실행 추적이 아닙니다.

Ruflo가 처음이신가요? 314개의 MCP 도구나 26개의 CLI 명령을 배울 필요는 없습니다. init 후에는 Claude Code를 평소처럼 사용하기만 하면 됩니다 — 훅 시스템이 자동으로 작업을 라우팅하고, 성공 패턴에서 학습하며, 백그라운드에서 에이전트를 조율합니다.

검사할 수 있는 기원

Reuven Cohen (rUv)이 원래 Claude Flow로 만들었습니다. 첫 커밋인 2025년 6월 2일은 재귀적 에이전트 사이클을 위한 코드 오케스트레이션 계층을 설명합니다: Claude가 작성하고, 편집하고, 테스트하고, 개선합니다. 6월 10일 소스 스냅샷은 오케스트레이션, 작업 스케줄링, 메모리, 터미널 모듈을 추가합니다.

하네스는 모델을 둘러싼 작업대입니다: 작업을 조직하고, 단계 사이에 컨텍스트를 전달하며, 결과 확인을 돕습니다. 이는 Ruflo의 계보를 확립하는 것이지, 모든 Claude Code 도구를 통틀어 보편적인 최초를 주장하는 것이 아닙니다. 삽화 설명, 정확한 커밋, 초기 생태계 맥락을 참고하세요.

Grok Build: npx ruflo init --grok은 프로젝트 호스트 표면(.grok/, 팀 버스, 운영자 가이드)을 작성하며 프로젝트 외부에는 아무것도 쓰지 않습니다. 미리 보려면 --dry-run을 추가하세요. 설정, spawn_subagent 계약, 선택적 상태 행, Grok 업데이트 시 다시 확인할 사항: Grok 운영자 가이드.

📖 배경 — 이름의 유래

Claude Flow는 이제 Ruflo입니다 — Rust, 플로우 상태, 그리고 필연적으로 느껴지는 무언가를 만드는 것을 사랑하는 rUv가 이름을 지었습니다. "Ru"는 rUv입니다. "flo"는 새벽 3시까지 작업하는 것입니다. 그 밑에는 Cognitum.One 에이전틱 아키텍처가 구동하며, 강화된 Rust 기반 AI 엔진, 임베딩, 메모리, 플러그인 시스템을 실행합니다.

애니메이션 데모 열기 · Theme Studio 가이드 · 워크플로 데모

여러분의 에이전트 콕핏. Claude Code 옆에서 워크플로, 에이전트, 모델, 토큰, 비용을 추적하세요. 38초 애니메이션은 실제 렌더러 프레임을 통해 Orbital과 Theme Studio를 보여주며, 부팅 검사, 6가지 팔레트, 커스터마이징, 저장된 테마, JSON 가져오기, 크기 조정을 포함합니다. 이 컴팩트한 3.84 MB SVG는 456개 프레임을 모두 유지합니다. 네이티브 호스트 및 AI 제공자 실행은 시연되지 않습니다.

모든 실행을 검사하세요. 에이전트 로그와 결과를 열고, 검색하고, 실패를 분류하고, 재생하고, 비교하세요. npx ruflo init으로 시작하고, Claude Code를 재시작한 다음, /ruflo를 실행하세요. 전체 콘솔 투어.

Claude가 주도하게 하세요. 한계는 여러분이 설정합니다. Settings → Claude control을 활성화하여 콘솔 작업을 탐색하고 실행하세요. read, write, manage, full 중에서 선택하고, ask 또는 auto 승인을 선택하세요. 현재 기본값은 read + ask이며, 레벨을 높이는 것은 여러분의 선택입니다. 권한 레벨을 초과하는 작업은 거부되며, 네트워크, 지출, 파괴적 작업은 auto에서도 확인이 필요합니다. 실시간 작업 로그를 검토하거나 Take back control을 눌러 Claude control을 중지하세요. 세부 정보.

한 가지 작업: Claude로 미션 만들기
아래 녹화된 콘솔 세션을 시청하세요. Claude가 미션을 만들고, Learning 및 Security 페이지를 열고, Overview에서 자신의 작업을 보고합니다.

경계를 설정하세요. 아래 명령으로 콘솔을 설치하고, /ruflo를 연 다음, Settings → Claude control → write + ask를 선택하세요.
구체적인 요청을 하세요. 시도해 보세요: "다크 모드 토글을 추가하는 미션을 만들어 줘. 미션과 그 상태를 보여 줘."
생성을 승인하세요. Claude가 Missions를 열고 목표를 설정합니다. 콘솔에서 대기 중인 create 작업을 확인하세요.
결과를 검증하세요. Missions에 목표가 포함되어 있고 Overview에 작업이 기록되어 있는지 확인하세요. 미션을 만드는 것이 기능이 구현되었다는 뜻은 아닙니다.
통제를 유지하세요. Take back control은 Claude의 콘솔 도구를 일시 중지합니다. 이후 호출은 통제를 복원할 때까지 거부되어야 합니다.

녹화가 보여주는 것: write + auto를 사용한 실제 Claude Haiku 세션, 미션 생성, 페이지 탐색, 거부된 스웜 중지, 통제 회수. 위 단계는 ask를 사용하므로 여러분이 직접 생성을 승인합니다. 링크된 워크플로 애니메이션은 샘플 데이터를 사용하고, 테마 데모는 렌더러 프레임을 재생합니다. 둘 다 완료된 스웜 작업이나 메모리 회상의 증거가 아닙니다.

구현 및 녹화된 테스트 결과 · 재현 스크립트

ruflo 마켓플레이스에서 mods를 설치하세요 (Claude Code 2.1.287 이상, mods는 계정 권한으로 실행되며 샌드박스되지 않으므로 먼저 코드를 읽으세요):

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins

ruflo-console은 위의 콕핏이고, ruflo-mods는 프롬프트를 라우팅하고 프로세스 내에서 정책을 적용하며, ruflo-swarm은 창에 스웜을 표시하고, ruflo-ruos는 ruOS 상태 세그먼트를 추가합니다. /plugin을 열어 활성 mods 줄에 나타나는지 확인하세요. 콘솔 안에서 /ruflo market은 Plugin Catalog입니다: 모든 ruflo 플러그인, mod, 스킬과 그것이 제공하는 것, 그리고 설치, 활성화, 비활성화, 업데이트 버튼(각각 먼저 확인을 요청).

빠른 시작

표면적이 매우 다른 두 가지 설치 경로가 있습니다. 필요한 것에 따라 선택하세요 (#1744):

Claude Code Plugin
CLI 설치 (npx ruflo init)

제공하는 것
슬래시 명령 + 몇 가지 스킬 + 플러그인별 에이전트 정의
전체 Ruflo 루프 — 98개 에이전트, 60개 이상 명령, 30개 스킬, MCP 서버, 훅, 데몬

워크스페이스의 파일
없음
.claude/, .claude-flow/, CLAUDE.md, 헬퍼, 설정

MCP 서버 등록
ruflo-core가 설치된 경우에만 (자체 .mcp.json 제공) — 대부분의 다른 플러그인은 아님
예

훅 설치
아니요
예

적합한 용도
전체 설치에 확정하지 않고 단일 플러그인의 명령을 시험
프로덕션 사용 — 문서대로 모두 작동

경로 A — Claude Code 플러그인 (라이트, 슬래시 명령만)
# 마켓플레이스 추가
/plugin marketplace add ruvnet/ruflo

# core + 필요한 플러그인 설치
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo
이것은 슬래시 명령과 에이전트 정의를 추가합니다. ruflo-core(위에서 설치)는 설치 시 자체 MCP 서버를 등록합니다 — 그 도구는 mcp__plugin_ruflo-core_ruflo__*(예: mcp__plugin_ruflo-core_ruflo__memory_store)로 호출 가능하며, CLI 트랙 스캐폴드가 사용하는 단순한 memory_store / swarm_init / agent_spawn 이름이 아닙니다. 다른 플러그인은 일반적으로 자체 MCP 서버를 제공하지 않습니다. CLI 트랙 도구 이름을 사용하는 전체 루프는 아래 경로 B를 사용하세요.

🔌 35개 플러그인 전체
핵심 및 오케스트레이션

플러그인
하는 일

ruflo-core
기반 — 서버, 상태 검사, 플러그인 검색

ruflo-swarm
여러 에이전트를 팀으로 조율

ruflo-autopilot
에이전트가 루프에서 자율적으로 실행되게 함

ruflo-loop-workers
백그라운드 작업을 타이머로 스케줄

ruflo-workflows
재사용 가능한 다단계 작업 템플릿

ruflo-federation
다른 머신의 에이전트가 안전하게 협업

메모리 및 지식

플러그인
하는 일

ruflo-agentdb
에이전트 메모리용 고속 벡터 데이터베이스

ruflo-rag-memory
스마트 검색 — 하이브리드 검색, 그래프 홉, 다양성 순위

ruflo-rvf
세션 간 에이전트 메모리 저장 및 복원

ruflo-ruvector
ruvector — GPU 가속 검색, Graph RAG, 103개 도구

ruflo-knowledge-graph
엔티티 관계 맵 구축 및 탐색

지능 및 학습

플러그인
하는 일

ruflo-intelligence
에이전트가 과거 성공에서 학습하고 더 똑똑해짐

ruflo-graph-intelligence
서브리니어 그래프 추론 — PageRank, 델타 업데이트, 복잡도 인식 실행 (ADR-123)

ruflo-daa
동적 에이전트 동작과 인지 패턴

ruflo-ruvllm
로컬 LLM(Ollama 등)을 스마트 라우팅으로 실행

ruflo-goals
큰 목표를 계획으로 나누고 진행 상황 추적

코드 품질 및 테스트

플러그인
하는 일

ruflo-testgen
누락된 테스트를 찾아 자동 생성

ruflo-browser
Playwright로 브라우저 테스트 자동화

ruflo-jujutsu
git diff 분석, 위험 점수 산정, 리뷰어 제안

ruflo-docs
문서를 자동 생성 및 유지

agentic-qe-fleet
외부, Agentic QE가 유지 관리: 11개 QE 에이전트, 테스트 생성, 커버리지, 카오스 및 TDD 스킬, agentic-qe MCP 서버, AQE 학습 데이터 가드 (/plugin install agentic-qe-fleet@ruflo). 하나의 마켓플레이스에서만 설치하세요, agentic-qe 또는 ruflo: 둘 다에서 활성화하면 mod와 명령이 두 번 로드됩니다

보안 및 규정 준수

플러그인
하는 일

ruflo-security-audit
취약점 및 CVE 스캔

ruflo-aidefence
프롬프트 인젝션 차단, PII 탐지, 안전 스캔

아키텍처 및 방법론

플러그인
하는 일

ruflo-adr
살아있는 기록으로 아키텍처 결정 추적

ruflo-ddd
도메인 주도 설계 스캐폴드 — 컨텍스트, 애그리거트, 이벤트

ruflo-sparc
품질 게이트가 있는 5단계 개발 방법론 가이드

ruflo-metaharness
에이전트 설정을 평가하고, 도구 구성을 보안 위험에 대해 스캔하며, 시간에 따른 변경을 추적 (가이드)

ruflo-arena
경쟁적 ruliology — 에이전트 전략을 토너먼트에서 겨루게 하고, 힐클라임 및 우승자 공동 진화 (ADR-147/148)

DevOps 및 관측성

플러그인
하는 일

ruflo-migrations
데이터베이스 스키마 변경을 안전하게 관리

ruflo-observability
구조화된 로그, 추적, 메트릭을 한곳에

ruflo-cost-tracker
토큰 사용량 추적, 예산 설정, 비용 알림

확장성

플러그인
하는 일

ruflo-agent
에이전트 실행 — 로컬 WASM 샌드박스(rvagent) + Anthropic Claude Managed Agents(클라우드), 옵트인 경계 동적 워크플로, 게이트된 세션 제어, 검증된 권고 학습

ruflo-plugin-creator
스캐폴드, 검증, a…