LLM Wiki

TestSprite CLI: 코딩 에이전트가 만든 코드를 실제 앱에서 검증하는 테스트 도구

Properties2
descriptionTestSprite CLI는 코딩 에이전트가 생성한 코드를 목(mock)이 아니라 실제 실행 중인 앱을 대상으로 검증하도록 돕는 공식 CLI 도구다.
tagsai-agents, research

6 min read

출처

개요

TestSprite CLI는 코딩 에이전트가 생성한 코드를 목(mock)이 아니라 실제 실행 중인 앱을 대상으로 검증하도록 돕는 공식 CLI 도구다. 프론트엔드와 백엔드를 실제 브라우저나 API 환경에서 테스트하고, 실패 시 에이전트가 바로 읽을 수 있는 형태의 실패 번들을 제공하는 데 초점을 둔다. 핵심 흐름은 create → run → failure get → fix → rerun으로 이어지는 반복 검증 루프다. 사람도 터미널이나 CI에서 같은 인터페이스를 사용할 수 있으며, 에이전트용 온보딩 명령도 제공한다. CLI 자체는 Apache-2.0으로 공개되어 있지만, 연결되는 TestSprite 클라우드 플랫폼은 API 키가 필요한 서비스다.

핵심 포인트

  • TestSprite CLI는 코딩 에이전트가 만든 코드를 실제 사용자처럼 실행 중인 앱에서 조작하고 검증하는 데 초점을 둔다.
  • 실패 결과는 test failure get 명령으로 가져오며, 실패 단계, 전후 단계, 스크린샷, DOM 스냅샷, 테스트 소스, 원인 가설, 권장 수정 대상 등을 하나의 자기완결적 번들로 제공한다.
  • 실패 관련 데이터는 같은 snapshotId를 공유하며, CLI는 서로 다른 실행의 데이터를 섞는 것을 거부하도록 설계되어 있다.
  • 테스트 흐름은 일회성 실행이 아니라 test create, test run, test failure get, 수정, test rerun으로 이어지는 반복 루프다.
  • 기존 동작이 이미 테스트 모음에 포함되어 있으면 testsprite test rerun으로 회귀 여부를 확인하고, 없으면 testsprite test create로 새 테스트를 만든다.
  • —output json, 예측 가능한 exit code, —dry-run 등을 제공해 스크립트와 CI 환경에서 사용하기 좋게 설계되어 있다.
  • testsprite setup 또는 testsprite agent install 계열 명령으로 Claude, Cursor, Cline, Windsurf, Codex 등 코딩 에이전트에 검증 루프용 스킬을 설치할 수 있다.

왜 중요한지

코딩 에이전트는 빠르게 코드를 생성할 수 있지만, 그 코드가 실제 제품 환경에서 의도대로 동작하는지 확인하는 과정은 여전히 병목이 되기 쉽다. TestSprite CLI는 테스트 실패 정보를 사람이 읽는 리포트가 아니라 에이전트가 바로 원인 분석과 수정에 활용할 수 있는 입력으로 제공한다는 점에서 의미가 있다. 특히 실제 브라우저나 API를 대상으로 검증하고, 실패 맥락을 단일 번들로 묶어 주는 방식은 에이전트 기반 개발 루프의 자동화 가능성을 높인다. 다만 원문 기준으로는 TestSprite 클라우드 플랫폼과 API 키가 필요하므로, CLI만으로 완전히 독립적인 로컬 테스트 도구라고 보기는 어렵다.

설치 및 기본 사용 흐름

요구 사항

  • Node.js 20.19+, 22.13+, 또는 24+
  • TestSprite API 키

기본 설치

npm install -g @testsprite/testsprite-cli
testsprite setup

전역 설치 없이도 다음처럼 실행할 수 있다.

npx @testsprite/testsprite-cli

비대화형 환경 예시

TESTSPRITE_API_KEY=sk-... testsprite setup --from-env --yes --agent claude

테스트 루프 예시

testsprite test create --project proj_8f0f6 --type frontend \
  --plan-from ./checkout-flow.plan.json --run --wait --output json

실패한 경우:

testsprite test failure get test_3a9f21c7 --out ./.testsprite/failure

수정 후 재실행:

testsprite test rerun test_3a9f21c7 --wait --output json

주요 명령어 범주

  • Setup: setup
    • API 키 설정, 검증, 에이전트용 검증 스킬 설치
  • Auth: auth status, auth remove
    • 활성 프로필의 사용자, 키, 스코프 확인 및 제거
  • Read: test get, test failure get, test failure summary
    • 프로젝트와 테스트 조회, 실패 번들 및 요약 확인
  • Write: test create, test create-batch, test code put
    • 테스트 생성, 플랜 기반 일괄 생성, 생성 코드 교체
  • Run: test run, test rerun, test wait
    • 테스트 실행, 재실행, 특정 실행 대기
  • Agent: agent install, agent list
    • 코딩 에이전트 대상 스킬 설치 및 목록 확인

후속으로 볼 링크

후속 키워드

  • AI testing agent
  • E2E testing
  • coding agent validation
  • test failure bundle
  • browser automation testing
  • CI 테스트 자동화
  • agentic coding workflow
  • regression testing
  • TestSprite CLI
  • Claude Code / Codex / Cursor 테스트 루프

원문 보존 위치

원문 전체는 raw source: web-2026-07-09-pytorchkr-topic-11160-testsprite-cli-agent-code-verification-tool에 source_url 및 HTML 원문과 함께 저장되어 있습니다.

백링크