reticlehq/reticle

AI agents can generate code, but still struggle to understand what they build. Reticle brings Jev-style machine-native runtime perception to web & desktop applications.

해결하는 문제

코딩 에이전트는 자신이 작성한 코드에 기반하여 변경 사항이 작동한다고 가정하는 경우가 많지만, 실제로 실행 중인 애플리케이션을 검증하는 경우는 드뭅니다. 이는 깨진 모달, 500 에러, UI 버그와 같은 '침묵의 실패'로 이어지며, 이러한 문제는 수동 QA 과정에서 인간 개발자가 발견하게 됩니다. Reticle은 실제 앱을 구동하고 내부 상태를 관찰함으로써 에이전트가 낙관적인 가정에서 벗어나 구체적인 검증을 수행할 수 있는 방법을 제공합니다.

작동 방식

Reticle은 애플리케이션에 설치되는 개발 전용 SDK(React, Next.js, Vue, Svelte, Angular 등의 프레임워크 지원)와 실행 중인 앱을 코딩 에이전트에 연결하는 브릿지를 사용합니다.

표면(DOM)만 확인하는 기존 테스트 도구와 달리, Reticle은 앱을 내부에서 읽어들입니다. 에이전트는 네트워크 응답, 애플리케이션 상태(Zustand, Redux, Pinia 등), 콘솔 에러, 그리고 UI 요소와 관련된 특정 소스 코드 라인을 관찰할 수 있습니다. 에이전트가 작업을 수행하면 Reticle은 단순한 스크린샷이 아닌, 네트워크 상태 코드나 상태 변경과 같은 증거를 바탕으로 yes, no, 또는 unknown 판정을 반환합니다.

대상 사용자

AI 코딩 에이전트(Claude Code, Cursor, Windsurf, VS Code 등)를 사용하며, 웹 또는 데스크톱(Electron, Tauri) 애플리케이션에서 에이전트의 작업 결과에 대한 검증을 자동화하고자 하는 개발자.

주요 특징

  • 내부 가시성: 화면상에서는 숨겨진 네트워크 요청, 상태 저장소, 콘솔 로그를 확인할 수 있습니다.
  • 에이전트 네이티브: MCP (Model Context Protocol)를 통해 통합되어 에이전트가 관찰, 행동, 단언을 수행할 수 있는 도구를 제공합니다.
  • 결정론적 리플레이: 성공적인 여정을 '플로우'로 저장하여 AI 모델 없이도 재확인할 수 있습니다.
  • CI 통합: reticle gate 명령어가 포함되어 있어, 이전에 저장된 플로우를 깨뜨리는 변경 사항을 실패 처리할 수 있습니다.
  • 운영 환경 안전성: SDK는 프로덕션 빌드에서 제거되며 로컬 루프백 주소에서만 수신 대기합니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트