umputun/ralphex

어떤 프로젝트인가요?

핵심 기능

• 01각 계획 작업을 Claude Code 또는 codex의 새 세션에서 실행하고, 작업마다 검증을 수행합니다.
• 02병렬 리뷰 에이전트와 선택형 외부 리뷰어를 활용해 여러 단계의 리뷰 파이프라인을 실행합니다.
• 03계획 파일명으로 git 브랜치를 만들고, 각 작업과 리뷰 수정이 끝날 때마다 커밋합니다.
• 04하나의 저장소에서 여러 계획을 병렬 실행할 수 있도록 git worktree를 지원합니다.
• 05--serve 플래그로 실시간 웹 대시보드를 제공합니다.
• 06자율 에이전트가 접근할 수 있는 범위를 제한하도록 Docker 컨테이너에서 실행할 수 있습니다.

활용 사례

• 터미널을 사용하지 않는 동안 작성된 계획을 바탕으로 여러 작업으로 구성된 기능을 구현합니다.
• 다른 도구나 수작업으로 ralphex 외부에서 변경한 코드를 자동으로 리뷰합니다.
• 별도의 worktree에서 여러 독립적인 계획을 동시에 실행합니다.
• Claude 구독을 이용할 수 없을 때 codex만 실행 도구로 사용합니다.

빠른 시작

1. 1

   Go로 ralphex를 설치합니다

2. 2

   docs/plans/에 계획 파일을 만듭니다

3. 3

   계획 파일을 대상으로 ralphex를 실행합니다

   ralphex docs/plans/my-feature.md

사용 전 알아둘 점

• !Claude Code 또는 codex 코딩 에이전트를 별도로 설정해야 합니다.
• !Claude 기본 모드에서는 claude --print를 사용하며, 2026년 6월 15일부터 Anthropic의 새로운 Agent SDK 크레딧 과금이 적용됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

ralphex은(는) 무엇인가요?

Markdown 구현 계획을 바탕으로 Claude Code 또는 codex를 자율 실행하고, 작업마다 새 세션을 사용하며 여러 단계의 코드 리뷰를 수행하는 독립형 Go CLI입니다. ralphex는 Git 저장소 루트에서 실행되어 Claude Code 또는 codex CLI를 조율하고, 감독 없이 구현 계획을 수행하는 명령줄 도구입니다. 계획은 작업과 검증 명령을 담은 Markdown 파일입니다. 각 작업은 새 코딩 에이전트 세션에서 실행되므로 계획이 진행되는 동안 컨텍스트를 작게 유지할 수 있습니다. 각 작업이 끝나면 검증 명령을 실행하고, 체크박스를 표시한 뒤 변경 사항을 커밋합니다.

ralphex은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ralphex은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ralphex은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ralphex의 마지막 커밋은 2026년 11월 2일입니다.

ralphex은(는) 어디에 사용할 수 있나요?

터미널을 사용하지 않는 동안 작성된 계획을 바탕으로 여러 작업으로 구성된 기능을 구현합니다. 다른 도구나 수작업으로 ralphex 외부에서 변경한 코드를 자동으로 리뷰합니다. 별도의 worktree에서 여러 독립적인 계획을 동시에 실행합니다. Claude 구독을 이용할 수 없을 때 codex만 실행 도구로 사용합니다.

ralphex는 어떻게 설치하나요?

Go로 ralphex를 설치합니다 docs/plans/에 계획 파일을 만듭니다 계획 파일을 대상으로 ralphex를 실행합니다: ralphex docs/plans/my-feature.md

ralphex은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/umputun/ralphex