Git History Viewer

Бесплатный локальный граф истории Git только для чтения для браузера, CLI и MCP-клиентов.

Публичная альфа. В управляемых средах закрепляйте точную версию.

Установка

Требуется Node.js 22 или новее и Git 2.40 или новее.

npm install --global @peekaboo-develop/git-history-viewer@alpha

Related MCP server: git-insights-mcp

Открытие репозитория

cd /path/to/repository
git-history-viewer web .

Просмотрщик открывает сеанс браузера только через loopback для этой рабочей копии. Он не клонирует, не выполняет fetch, pull, push и не изменяет состояние Git. Ссылки отслеживания удалённых веток (remote-tracking refs) показывают последнее состояние, полученное вашим существующим рабочим процессом Git.

Для настройки MCP начните с доступа только к метаданным:

git-history-viewer mcp --repo /absolute/path/to/repository --content-policy metadata

Разработка

npm install
npm test
npm run license:check
npm run test:pack
node bin/git-history-viewer.mjs web . --port 0 --no-open
node bin/git-history-viewer.mjs web . --port 0 --no-open --ollama-model qwen3:4b
node bin/git-history-viewer.mjs config path
node bin/git-history-viewer.mjs config validate
node bin/git-history-viewer.mjs profiles list
node bin/git-history-viewer.mjs web . --ai-profile local-fast --ai-profile local-deep
node bin/git-history-viewer.mjs mcp --repo /absolute/path --content-policy metadata
node bin/git-history-viewer.mjs cache status

Политика MCP по умолчанию не раскрывает патчи, адреса электронной почты авторов и абсолютные пути. Приложение никогда не получает и не изменяет состояние Git.

Заголовок Web содержит руководство AI接続 для проверенных шаблонов настройки MCP для Codex, Claude Code и Cursor. Он никогда не редактирует конфигурацию клиента и не раскрывает абсолютный путь репозитория. Выбранный коммит может создать короткий MCP-промпт, содержащий только его OID.

Дополнительный сценарий Web AI отключён, если не указан параметр --ai-profile или устаревший параметр --ollama-model. Профили поддерживают Ollama с числовым loopback и официальные API OpenAI, Anthropic и Google. Каждый провайдер показывает предварительный просмотр точной полезной нагрузки метаданных и требует второго клика перед генерацией. Когда включено несколько профилей, панель сведений предоставляет выбор модели. Удалённые конечные точки и имена учётных данных зафиксированы в коде: OpenAI читает OPENAI_API_KEY, Anthropic читает ANTHROPIC_API_KEY, а Google читает GEMINI_API_KEY. Ключи никогда не принимаются из браузера или файла конфигурации. Loopback сам по себе не доказывает, где Ollama выполняет модель. Патчи, содержимое файлов, идентификационные данные, абсолютные пути, ссылки (refs), удалённые репозитории (remotes) и идентификаторы коммитов не отправляются.

Путь к конфигурации зависит от ОС и выводится командой config path. Строгий формат JSON не хранит учётные данные, произвольные конечные точки, промпты или имена переменных окружения:

{
  "schemaVersion": "1",
  "defaultProfileId": "local-fast",
  "profiles": [
    {
      "id": "local-fast",
      "label": "Local fast",
      "provider": "ollama",
      "model": "qwen3:4b",
      "ollamaPort": 11434,
      "maxOutputTokens": 1536
    },
    {
      "id": "openai-fast",
      "label": "OpenAI fast",
      "provider": "openai",
      "model": "gpt-5.4-mini",
      "maxOutputTokens": 1536
    },
    {
      "id": "claude-balanced",
      "label": "Claude balanced",
      "provider": "anthropic",
      "model": "claude-sonnet-4-6",
      "maxOutputTokens": 1536
    },
    {
      "id": "gemini-fast",
      "label": "Gemini fast",
      "provider": "google",
      "model": "gemini-2.5-flash",
      "maxOutputTokens": 1536
    }
  ]
}

Изменения конфигурации требуют перезапуска. Параметр --ai-profile можно указывать несколько раз; он является явным списком разрешений для этой Web-сессии. Экспортируйте соответствующий фиксированный ключ только при выборе удалённого профиля.

Кэш результатов AI использует ограниченные шардированные JSON-файлы в пользовательском каталоге кэша операционной системы. Метаданные кэша не хранят ключи API, исходные промпты, диффы, пути репозиториев или удалённые URL-адреса; сгенерированные результаты всё же могут повторять чувствительный исходный текст. --no-ai-cache обходит чтение и запись. cache clear удаляет только распознанные файлы записей кэша.

Панель сведений о коммите может рекомендовать до двух версионно-нейтральных ссылок из скомпилированного реестра официальной документации для явных маркеров пути, таких как рабочие процессы GitHub Actions, файлы Docker/Compose, TSConfig, конфигурация Vite и Vue SFC. Отображение ссылок не выполняет сетевых обращений. Отдельная кнопка может загружать ограниченные фрагменты непосредственно с этих фиксированных официальных URL-адресов через HTTPS-транспорт с защитой от DNS-ребinding и закреплённым IP-адресом. Получатель может определить обнаруженную технологию, но имена репозиториев, пути, коммиты, сообщения, cookie, учётные данные и рефереры не отправляются. Перенаправления отклоняются. Когда AI включён, ещё один отдельный предпросмотр и подтверждение могут отправлять отображаемые фрагменты вместе с непрозрачными идентификаторами цитирования выбранному провайдеру; официальные URL-адреса и заголовки никогда не отправляются модели и сопоставляются обратно только сервером. Определение версии остаётся недоступным.

См. docs/PRODUCT_SPEC.md, docs/ARCHITECTURE.md, docs/MCP.md, docs/SECURITY.md и docs/ROADMAP.md — там описаны нормативный дизайн и планируемая поддержка удалённых сред.

Подготовка релиза и откат описаны в docs/RELEASING.md. Сборка артефакта не даёт разрешения на его публикацию.