kemal-arslan/reposherlockПроанализируйте любой репозиторий GitHub (URL или локальный путь) → карта архитектуры, проверенные команды запуска, риски и действенные проблемы - за минуты.
Английский | Türkçe
Вставьте URL репозитория GitHub или локальный путь и получите архитектуру, инструкции по запуску, риски и действенные проблемы.
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 (только с --try-run)pr_draft.md (только с --pr-draft или при использовании профиля Full Sherlock в мастере)Если включена обработка 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
В текущем выпуске рабочий процесс CLI RepoSherlock работает с включённой обработкой 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
# или
npm test
MIT