RCFlow: Claude Code, Codex 및 OpenCode를 위한 멀티 세션 관리 기능이 있는 오픈소스 오케스트레이터

RCFlow는 AI 코딩 에이전트 — Claude Code, Codex, OpenCode — 를 위한 오픈소스 오케스트레이터입니다. tmux 창에서 8-10개의 병렬 코딩 세션을 관리할 때 발생하는 문제(세션이 주의에서 사라짐, 확인 누락, 프롬프트 망각)를 해결합니다. RCFlow는 모든 세션을 상태와 함께 한 UI에서 볼 수 있게 해줍니다.

주요 기능

• 계층적 구성: 하나의 사이드바에서 머신 → 프로젝트 → 세션을 구성합니다. 상태 점으로 실행 중, 일시 중지, 대기 중, 완료를 표시합니다.
• 하나의 클라이언트, 여러 워커: 단일 클라이언트가 모든 머신(Linux, macOS, Windows, WSL)의 백엔드에 연결됩니다. 클라이언트는 Android에서도 실행됩니다.
• 작업 탭: 먼저 작업과 설명을 작성한 후, 이를 기반으로 세션을 시작합니다.
• 준비 계획: 기능을 구현하는 세션 전에 계획을 초안으로 작성합니다.
• 아티팩트 탭: RCFlow가 세션 메시지를 읽고 정규식을 통해 파일 경로를 추출하여(구성 가능 — .md 파일, .exe 파일, 로그 등 추적) 한 곳에 표시합니다.
• 실제로 작동하는 워크트리: git 워크트리를 생성하고, 패키지 매니저를 자동 감지(npm/yarn/pnpm/bun, pip/poetry/uv/pipenv, cargo, go mod, bundle, dotnet, maven, gradle)하며, install을 실행하고, 기본적으로 .env를 복사합니다(프로젝트별 구성 가능).
• 텔레메트리 및 분석: 토큰 사용량, 지연 시간, 도구 호출 메트릭에 대한 실시간 차트를 제공하며, 세션별 및 집계 드릴다운이 가능합니다.
• 실시간 구성: REST를 통해 런타임에 LLM 공급자, API 키, 포트 및 기타 설정을 변경할 수 있습니다. 재시작이 필요 없습니다.
• 오케스트레이터 LLM: 코딩 에이전트 위의 헬퍼 레이어(오토파일럿 아님)로, Anthropic, AWS Bedrock 또는 모든 OpenAI 호환 엔드포인트에 플러그인 가능합니다.

설치 (Linux/macOS)

curl -fsSL https://rcflow.app/get-worker.sh | sh # 백엔드
curl -fsSL https://rcflow.app/get-client.sh | sh # 데스크톱 클라이언트

Linux, macOS, Windows, Android용 사전 빌드된 클라이언트는 릴리스 페이지에서 확인할 수 있습니다. 최신 버전은 v0.43.0입니다.

스택

• 클라이언트: Flutter
• 백엔드: Python 3.12 + FastAPI (uv로 관리)
• 데이터베이스: SQLite (별도 서비스 불필요)
• 라이선스: AGPL v3

Claude Code와의 통신 방식

RCFlow는 각 에이전트의 API를 최대한 활용합니다. 참고: Claude Code의 API는 파일이 편집되었고 어떤 파일인지 알려주지만, diff는 제공하지 않습니다. RCFlow는 이를 우회하여 UI에 diff를 표시해야 했습니다.

솔직히 말해 미숙한 부분

• 앱이 세션 중간에 충돌하거나 재시작되면 가끔 메시지 손실이 발생합니다(전체 세션이 아닌 개별 메시지).
• 세션 일시 중지/재개에는 숨겨진 복잡성이 있습니다. 에이전트가 멈추기 전에 잠시 계속 작업하는 경우가 있습니다.
• 첨부 파일은 작동하지만 미완성 상태입니다. 현재는 컨텍스트에 덤프된 텍스트로, 에이전트가 읽고 복사할 수 있는 실제 파일로 처리되지 않습니다.

다음 개발 예정

전파 관련 기능이 개발 중입니다(자세한 내용은 소스 참조).