Visor de historial de Git

Un grafo de historial de Git gratuito, local y de solo lectura para el navegador, la CLI y los clientes MCP.

Alfa pública. Fija una versión exacta en entornos gestionados.

Instalación

Requiere Node.js 22 o posterior y Git 2.40 o posterior.

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

Related MCP server: git-insights-mcp

Abrir un repositorio

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

El visor abre una sesión de navegador solo de bucle local para esa copia de trabajo. No clona, obtiene, extrae, empuja ni modifica el estado de Git. Las referencias de seguimiento remoto muestran el último estado obtenido por tu flujo de trabajo de Git existente.

Para la configuración de MCP, comienza con acceso solo de metadatos:

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

Desarrollo

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

La política MCP predeterminada no expone parches, correos electrónicos de autores ni rutas absolutas. La aplicación nunca obtiene ni muta el estado de Git.

El encabezado Web incluye una guía AI接続 para plantillas de configuración MCP verificadas de Codex, Claude Code y Cursor. Nunca edita una configuración de cliente ni expone la ruta absoluta del repositorio. Una confirmación seleccionada puede producir un mensaje MCP corto que contiene solo su OID.

El flujo Web de IA opcional está deshabilitado a menos que se proporcione una opción --ai-profile o la opción heredada --ollama-model. Los perfiles admiten Ollama de bucle numérico y las API oficiales de OpenAI, Anthropic y Google. Cada proveedor previsualiza la carga útil de metadatos exacta y requiere un segundo clic antes de la generación. Cuando hay varios perfiles habilitados, el panel de detalles proporciona un selector de modelos. Los puntos finales remotos y los nombres de credenciales están fijos en el código: OpenAI lee OPENAI_API_KEY, Anthropic lee ANTHROPIC_API_KEY y Google lee GEMINI_API_KEY. Las claves nunca se aceptan desde el navegador o el archivo de configuración. El bucle no demuestra por sí solo dónde ejecuta Ollama un modelo. Los parches, contenidos de archivos, identidades, rutas absolutas, referencias, remotos e IDs de confirmación no se envían.

La ruta de configuración es específica del sistema operativo y se imprime con config path. El formato JSON estricto no almacena credenciales, puntos finales arbitrarios, mensajes ni nombres de variables de entorno:

{
  "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
    }
  ]
}

Los cambios de configuración requieren un reinicio. --ai-profile es repetible y es la lista de permitidos explícita para esa sesión Web. Exporta la clave fija correspondiente solo al seleccionar un perfil remoto.

La caché de resultados de IA utiliza archivos JSON fragmentados y limitados en el directorio de caché de usuario del sistema operativo. Los metadatos de caché no almacenan claves de API, mensajes sin procesar, diferencias, rutas de repositorio ni URL remotas; los resultados generados pueden repetir texto fuente sensible. --no-ai-cache omite lecturas y escrituras. cache clear elimina solo los archivos de entrada de caché reconocidos.

El panel de detalles de confirmación puede recomendar hasta dos enlaces neutrales de versión de un registro compilado de documentación oficial para marcadores de ruta sólidos como flujos de trabajo de GitHub Actions, archivos Docker/Compose, TSConfig, configuración de Vite y SFC de Vue. La visualización de enlaces no realiza acceso a la red. Un botón separado puede obtener extractos limitados directamente de esas URL oficiales fijas a través de un transporte HTTPS de IP fija resistente a la reasignación de DNS. El destino puede inferir la tecnología detectada, pero los nombres de repositorio, rutas, confirmaciones, mensajes, cookies, credenciales y referentes no se envían. Se rechazan las redirecciones. Cuando la IA está habilitada, otra vista previa y confirmación separadas pueden enviar los extractos mostrados más los IDs de cita opacos al proveedor seleccionado; las URL oficiales y los títulos nunca se envían al modelo y se asignan de nuevo solo por el servidor. La detección de versión sigue sin estar disponible.

Consulta docs/PRODUCT_SPEC.md, docs/ARCHITECTURE.md, docs/MCP.md, docs/SECURITY.md y docs/ROADMAP.md para el diseño normativo y el soporte remoto planificado.

La preparación de la versión y la reversión se documentan en docs/RELEASING.md. Construir un artefacto no autoriza a publicarlo.