kemal-arslan/reposherlockAnalizza qualsiasi repository GitHub (URL o percorso locale) → mappa dell'architettura, comandi di esecuzione verificati, rischi e problemi attuabili - in pochi minuti.
Inglese | Türkçe
Inserisci l'URL di un repository GitHub o un percorso locale e ottieni architettura, guida all'esecuzione, rischi e problemi attuabili.
RepoSherlock non si limita a indovinare i comandi. Con --try-run, tenta i passaggi di installazione/test/build/avvio in una sandbox e registra le prove (segnali, timeout e note) nel rapporto di esecuzione.
RepoSherlock analizza un repository GitHub pubblico o un percorso di progetto locale e scrive un bundle di report in:
.reposherlock/output/<run-dir>/La directory di esecuzione predefinita è basata su timestamp (ad esempio: 20260208-103104).
Gli artefatti includono:
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 (solo con --try-run)pr_draft.md (solo con --pr-draft o profilo Sherlock Completo della procedura guidata)Quando la lucidatura LLM è abilitata, vengono emesse varianti aggiuntive:
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 (consigliato):
bun install
bun run build
Fallback Node:
npm install
npm run build
Digitazione minima (procedura guidata interattiva):
bun run sherlock
Analizza un repository:
bun run sherlock -- analyze https://github.com/octocat/Hello-World --try-run
Analizza un percorso locale:
bun run sherlock -- analyze . --no-network --try-run
Apri il riepilogo per un'esecuzione esistente:
bun run sherlock -- report .reposherlock/output/<run-dir>
Verifica la toolchain locale:
bun run sherlock -- doctor
Modalità demo interfaccia:
bun run sherlock -- ui-demo
Fallback Node (se non usi Bun):
npm run sherlock
Il flusso di lavoro CLI di RepoSherlock viene eseguito con la lucidatura LLM abilitata nella versione corrente. L'analisi deterministica viene comunque prodotta e salvata insieme agli output lucidati dall'LLM.
Per i provider che richiedono credenziali (OpenAI, Gemini, Anthropic, Grok, compatibili con OpenAI), imposta:
export LLM_API_KEY="..."
Opzionale:
LLM_MODELLLM_BASE_URLPuoi anche impostare provider/modello/chiave nella procedura guidata interattiva e memorizzare la chiave in:
~/.reposherlock/credentials.json (chmod 600)RepoSherlock analizza la struttura del repository e i file chiave, costruisce un grafico dei moduli locali, estrae segnali di runtime/ambiente/rischio, esegue opzionalmente un tentativo in sandbox, quindi scrive un bundle di report. Quando la lucidatura LLM è abilitata, riscrive gli output deterministici per chiarezza senza modificare i comandi e i fatti scoperti.
sherlock.--try-run) e viene eseguito con timeout/limiti di output.bun test
# or
npm test
MIT