SantanderAI/ralph

의존성 없는 Bash/PowerShell 도구로 AI 코딩 에이전트를 루프에서 반복 실행하며 장시간 무인 작업 자동화

설치형 도구맘대로 써도 됨 · Apache-2.0자동화·워크플로우PowerShell난이도
79+11이번 주0 찜
21포크1이슈

중간맛 분석

스택: Bash/PowerShell 스크립트, Codex/Claude Code/Gemini /Devin 지원. 난이도: 중상. 즉시 활용: 예 — 설치 후 .ralph/.env 편집 한 번으로 최대 25회 루프 실행 가능. 기능: 반복마다 설정 재로드, 자동 에이전트 전환(토큰 소진 시), 메모리 상한선(systemd), 타임스탐프 로그 회전, stop.md로 우아한 중단.

이런 레포예요

이럴 때 쓰면 좋아요

  • 대규모 코드 리팩토링을 AI에게 여러 차례 반복 시키되, 매번 지난 진행상황을 읽고 다음 단계로 진전시키기
  • 토큰 한계나 크레딧 소진 시 자동으로 다른 AI 에이전트로 전환하며 장시간 작업 지속
  • 밤샐 동안 AI 에이전트가 설정된 메모리 제한 내에서 복잡한 태스크를 분할 수행하기

핵심 기능

매 반복마다 독립적인 에이전트 세션 시작 및 상태 파일시스템 기반 축적토큰 소진 시 자동 에이전트 전환(codex→claude→gemini→devin 순환)메모리 폭발 방지 위한 systemd 커널 수준 RAM 상한선 적용

대안 대비 차별점

의존성 없는 순수 셸 래퍼로 기존 AI CLI들을 엮어 장시간 무인 워크플로우를 가능하게 하며, 토큰 소진 감지 시 자동 에이전트 전환과 메모리 격리 등 프로덕션 안정성을 제공합니다.

준비물

  • Bash 또는 PowerShell
  • Codex, Claude Code, Gemini CLI, Devin 중 최소 하나

바로 시작하기

  1. Bash 설치 확인
bash --version
  1. 지원하는 AI CLI 중 최소 하나 설치 (Codex/Claude Code/Gemini CLI/Devin)
# Claude Code 예시
npm install -g @anthropic-ai/claude-code
  1. 저장소 클론
git clone https://github.com/SantanderAI/ralph.git
cd ralph
  1. 스크립트 설치 (~/.local/bin 으로)
just install

또는 수동으로:

cp ralph-loop.sh ~/.local/bin/
chmod +x ~/.local/bin/ralph-loop.sh
  1. 작업 디렉토리에서 설정 파일 생성 및 편집
mkdir workspace && cd workspace
ralph-loop.sh 1 /dev/null  # 첫 실행 시 .ralph/.env 자동 생성
  1. .ralph/.env 편집해 도구와 모델 선택
echo 'RALPH_TOOL=claude' >> .ralph/.env
echo 'RALPH_MODEL_CAPABILITY=high' >> .ralph/.env
  1. 프롬프트 파일 작성 후 루프 실행
echo '현재 plan/ 폴더를 읽고 다음 태스크를 진행하세요' > prompt.md
ralph-loop.sh 25 prompt.md

별 추이 · 7일

79+11 / 7일

활용성 · 따라 만들기 좋은가

따라 하기 좋음샘플 점수 52/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/SantanderAI/ralph.svg)](https://www.gitbap.com/r/SantanderAI/ralph)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기