kemal-arslan/reposherlockAnaliza cualquier repositorio de GitHub (URL o ruta local) → mapa de arquitectura, comandos de ejecución verificados, riesgos y problemas procesables - en minutos.
Inglés | Türkçe
Pegue una URL de repositorio de GitHub o una ruta local y obtenga arquitectura, guía de ejecución, riesgos y problemas procesables.
RepoSherlock no solo adivina comandos. Con --try-run, intenta pasos de instalación/prueba/construcción/inicio en un entorno aislado y registra evidencia (señales, tiempos de espera y notas) en el informe de ejecución.
RepoSherlock analiza un repositorio público de GitHub o una ruta de proyecto local y escribe un paquete de informe en:
.reposherlock/output/<run-dir>/El directorio de ejecución predeterminado se basa en marca de tiempo (por ejemplo: 20260208-103104).
Los artefactos incluyen:
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 el perfil Full Sherlock del asistente)Cuando el pulido LLM está habilitado, se emiten variantes adicionales:
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 (recomendado):
bun install
bun run build
Alternativa con Node:
npm install
npm run build
Mínima escritura (asistente interactivo):
bun run sherlock
Analizar un repositorio:
bun run sherlock -- analyze https://github.com/octocat/Hello-World --try-run
Analizar una ruta local:
bun run sherlock -- analyze . --no-network --try-run
Abrir resumen para una ejecución existente:
bun run sherlock -- report .reposherlock/output/<run-dir>
Verificar cadena de herramientas local:
bun run sherlock -- doctor
Modo demo de interfaz:
bun run sherlock -- ui-demo
Alternativa con Node (si no usas Bun):
npm run sherlock
El flujo de trabajo de la CLI de RepoSherlock se ejecuta con el pulido LLM habilitado en la versión actual. El análisis determinista aún se produce y guarda junto con las salidas pulidas por LLM.
Para proveedores que requieren credenciales (OpenAI, Gemini, Anthropic, Grok, compatible con OpenAI), establece:
export LLM_API_KEY="..."
Opcional:
LLM_MODELLLM_BASE_URLTambién puedes configurar proveedor/modelo/clave en el asistente interactivo y almacenar la clave en:
~/.reposherlock/credentials.json (chmod 600)RepoSherlock escanea la estructura del repositorio y archivos clave, construye un grafo de módulos local, extrae señales de tiempo de ejecución/entorno/riesgo, opcionalmente ejecuta una prueba en entorno aislado, luego escribe un paquete de informe. Cuando el pulido LLM está habilitado, reescribe las salidas deterministas para mayor claridad sin cambiar los comandos y hechos descubiertos.
sherlock.--try-run) y se ejecuta con tiempos de espera/límites de salida.bun test
# or
npm test
MIT