<p align="center">
<img src="https://raw.githubusercontent.com/rocketship-ai/rocketship/HEAD/docs/src/assets/black-logo-with-name-transparent.png#gh-light-mode-only" alt="Rocketship black logo" width="210" style="display: block; margin: 0 auto; padding: 20px;">
<img src="https://raw.githubusercontent.com/rocketship-ai/rocketship/HEAD/docs/src/assets/white-logo-with-name-transparent.png#gh-dark-mode-only" alt="Rocketship white logo" width="210" style="display: block; margin: 0 auto; padding: 20px;">
</p>
<h3 align="center">코딩 에이전트를 위한 QA 테스트 프레임워크.</h3>
<p align="center">당신의 코딩 에이전트가 웹 앱에 대한 E2E 테스트를 작성하고 실행하도록 하세요.</p>
<p align="center">
<a href="https://github.com/rocketship-ai/rocketship/releases"><img src="https://img.shields.io/github/v/release/rocketship-ai/rocketship.svg" alt="Github release"></a>
<a href="https://goreportcard.com/report/github.com/rocketship-ai/rocketship"><img src="https://goreportcard.com/badge/github.com/rocketship-ai/rocketship" alt="Go Report Card"></a>
<br>
</p>
<p align="center">
<a href="https://github.com/rocketship-ai/rocketship/releases">다운로드</a> ·
<a href="https://docs.rocketship.sh">문서(Documentation)</a>
</p>
rocketship demo gif
🚀 Rocketship은 오픈소스 QA 테스트 프레임워크로, Supabase, Playwright, Agent 등 커뮤니티 기반 플러그인을 사용하여 고객 여정(customer journeys)을 테스트할 수 있도록 코딩 에이전트가 활용할 수 있게 합니다. 이를 통해 코딩 에이전트는 로그인, 회원가입, 결제(checkouts) 등 중요한 사용자 흐름(user flows)이 조용히 깨지는 것을 방지하며 변경 사항을 배포할 수 있는 테스트 하네스(test harness)를 얻게 됩니다. 작동 방식은 다음과 같습니다:
- Rocketship CLI를 설치하고 저장소에
.rocketship 디렉토리를 추가합니다. 이 디렉토리에 있는 모든 .yaml 파일은 Rocketship에 의해 감지되어 실행됩니다.
- 코딩 에이전트(coding agent)가 새로운 기능, 고객 여정(customer journey) 또는 기타 사용자 중심 시나리오를 구축하고, 해당 흐름이 엔드 투 엔드(end-to-end)로 작동하는지 확인하는 Rocketship 테스트를 작성합니다.
- 머지(merge)하기 전에 로컬(및 CI)에서 이 테스트를 실행합니다. 일단 체크인(check-in)되면, 에이전트가 코드를 수정할 때마다 해당 흐름이 회귀(regression)로부터 보호됩니다.
핵심 기능 (Core Features)
- Rocketship CLI: 엔진을 로컬에서 실행하거나 원격 주소에 연결합니다.
- 선언적 YAML (Declarative YAML): 테스트 시나리오를 선언적 YAML 명세(spec)로 정의합니다.
- 내장 기능 (Built-in Features): 변수 전달(variable passing), 재시도 가능성(retryability), 라이프사이클 훅(lifecycle hooks) 등을 지원합니다.
- 플러그인 생태계 (Plugin Ecosystem): 자신에게 필요한 API와 프로토콜을 추가할 수 있습니다.
- 배포 준비 완료된 이미지 (Deploy-Ready Images): 히스토리를 저장하거나 정해진 일정에 따라 테스트를 실행해야 하나요? Rocketship을 자체 인프라(infra)에 호스팅하세요.
에이전트 퀵스타트 (Agent Quickstart)
ROCKETSHIP_QUICKSTART.md 파일을 코딩 에이전트의 컨텍스트 창(context window)에 붙여넣어, 에이전트가 테스트를 구축하고 실행하는 방법을 이해하도록 하세요.
컨텍스트가 확보되면 다음과 같은 작업을 수행할 수 있습니다:
- 중요한 흐름(로그인, 회원가입, 결제 등)에 대해
.rocketship/*.yaml 테스트를 제안하도록 요청합니다.
- 에이전트가 해당 흐름을 수정할 때마다 일치하는 Rocketship 테스트를 업데이트하도록 하고, 커밋(commit)하거나 PR(pull request)을 열기 전에
rocketship run -ad .rocketship을 실행합니다.
휴먼 퀵스타트 (Human Quickstart)
사전 요구 사항 (Prerequisites)
brew install temporal
...
설치 (Install)
Mac 사용자:
brew tap rocketship-ai/tap
brew install rocketship
Linux 사용자 (Linux bros):
curl -fsSL https://raw.githubusercontent.com/rocketship-ai/rocketship/main/scripts/install.sh | bash
테스트 명세 저장 (Save a test spec)
name: "Auth Flows"
tests:
...
실행하기 (Run it)
rocketship run -ad .rocketship
문서 (Documentation)
https://docs.rocketship.sh
기여하기 (Contribute!!!)
여러분과 함께 이 프로젝트를 만들어가고 싶습니다! LinkedIn을 통해 저에게 연락해 주세요. 함께 이야기해 봅시다. 가장 좋은 첫 번째 기여는 여러분이 즐겨 사용하는 API를 위한 플러그인 (plugin)을 만드는 것입니다. Rocketship에 기여하고 싶다면, Rocketship 기여하기 (Contributing to Rocketship)를 읽는 것부터 시작해 주세요.
라이선스 (License)
Rocketship은 MIT 라이선스 (MIT license) 하에 배포됩니다.
