
모든 GitHub 저장소(URL 또는 로컬 경로)를 분석 → 아키텍처 맵, 검증된 실행 명령어, 위험 요소 및 실행 가능한 이슈를 몇 분 안에 제공합니다.
영어 | Türkçe
GitHub 저장소 URL 또는 로컬 경로를 입력하면 아키텍처, 실행 안내, 위험 및 실행 가능한 이슈를 얻을 수 있습니다.

RepoSherlock은 명령어를 추측만 하지 않습니다. --try-run을 사용하면 샌드박스에서 설치/테스트/빌드/시작 단계를 시도하고 실행 보고서에 증거(신호, 시간 초과 및 메모)를 기록합니다.
RepoSherlock은 공개 GitHub 저장소 또는 로컬 프로젝트 경로를 분석하고 보고서 번들을 다음 위치에 작성합니다:
.reposherlock/output/<run-dir>/기본 실행 디렉터리는 타임스탬프 기반입니다 (예: 20260208-103104).
산출물에는 다음이 포함됩니다:
report.md / report.jsonarchitecture.mmd / architecture.jsonrisks.md / risks.jsonissues.jsonissues.good-first.md / issues.good-first.jsonREADME_2.0.mdrun_attempt.md / run_attempt.json (only with --try-run)pr_draft.md (only with or wizard Full Sherlock profile)LLM 다듬기가 활성화되면 추가 변형이 생성됩니다:
README_2.0.deterministic.md / README_2.0.llm.mdissues.deterministic.json / issues.llm.jsonreport.deterministic.md / report.llm.mdRun Plan
Target: https://github.com/octocat/Hello-World
Try-Run: enabled
Sherlock Thinking
✓ Validating repository target and runtime profile
✓ Planning scan strategy and safe execution path
✓ Preparing architecture, risk, and issue synthesis
Summary
Repo type: web
Risks: high=0, med=1, low=0
Output: .reposherlock/output/20260208-103104
Bun (권장):
bun install
bun run build
Node 대체:
npm install
npm run build
최소 입력 (대화형 마법사):
bun run sherlock
저장소 분석:
bun run sherlock -- analyze https://github.com/octocat/Hello-World --try-run
로컬 경로 분석:
bun run sherlock -- analyze . --no-network --try-run
기존 실행에 대한 요약 열기:
bun run sherlock -- report .reposherlock/output/<run-dir>
로컬 도구 체인 확인:
bun run sherlock -- doctor
UI 데모 모드:
bun run sherlock -- ui-demo
Node 대체 (Bun을 사용하지 않는 경우):
npm run sherlock
RepoSherlock CLI 워크플로는 현재 릴리스에서 LLM 다듬기가 활성화된 상태로 실행됩니다. 결정론적 분석은 여전히 생성되어 LLM으로 다듬어진 출력과 함께 저장됩니다.
자격 증명이 필요한 공급자(OpenAI, Gemini, Anthropic, Grok, OpenAI 호환)의 경우 다음을 설정하세요:
export LLM_API_KEY="..."
선택 사항:
LLM_MODELLLM_BASE_URL대화형 마법사에서 공급자/모델/키를 설정하고 키를 다음 위치에 저장할 수도 있습니다:
~/.reposherlock/credentials.json (chmod 600)RepoSherlock은 저장소 구조와 주요 파일을 스캔하고 로컬 모듈 그래프를 구축하며 런타임/환경/위험 신호를 추출하고 선택적으로 샌드박스 시험 실행을 수행한 후 보고서 번들을 작성합니다. LLM 다듬기가 활성화되면 발견된 명령어와 사실을 변경하지 않고 결정론적 출력을 명확하게 다시 작성합니다.
sherlock.--try-run)이며 시간 제한/출력 제한과 함께 실행됩니다.bun test
# or
npm test
MIT
--pr-draft