Integración con Git

Sincroniza automáticamente tus commits y pull requests para darle a tu asistente de IA contexto sobre los cambios en tu código. La actividad de GitHub aparece directamente en las tarjetas y vistas de detalle de tus tareas.

Cómo funciona

La integración con Git usa webhooks de GitHub para capturar automáticamente cada commit y PR que realizas. Una vez configurado, no necesitas hacer nada más: trabaja con normalidad y tu historial quedará guardado.

Configuración única (5 minutos)

Conecta tu repositorio y configura el webhook en GitHub. Esto se hace una sola vez por repositorio con la ayuda de Claude.

Automático para siempre

Cada push desde cualquier terminal, VS Code o la web de GitHub se guarda automáticamente. No se requiere ninguna acción.

El flujo

After Setup:

  You (any terminal)          GitHub                    ContextForge
       │                         │                            │
       │  git push               │                            │
       │───────────────────────▶│                            │
       │                         │                            │
       │                         │  webhook (automatic)       │
       │                         │───────────────────────────▶│
       │                         │                            │
       │                         │                            │  Saves commit
       │                         │                            │  to memory
       │                         │                            │

  Later, ask Claude:
  "What commits did I make this week?"
  "What changed in the auth module?"
  "Show me recent PRs"

Guía de configuración

Puedes conectar un repositorio de GitHub de dos formas: usando el Dashboard (recomendado) o mediante comandos MCP.

Conectar desde el Dashboard (Recomendado)

Ve a Configuración de cuenta

Navega a Dashboard → Account

Haz clic en "Connect Repository"

Introduce la URL de tu repositorio (p. ej., owner/repo o la URL completa de GitHub) y selecciona un proyecto.

Configura el webhook en GitHub

El diálogo te mostrará la Payload URL y el Secret con botones para copiarlos. Haz clic en el enlace para ir directamente a la configuración de webhooks de tu repositorio.

Activa

Después de añadir el webhook en GitHub, haz clic en "I've Added the Webhook - Activate" para comenzar la sincronización.

Conectar mediante comandos MCP

Paso 1: Pídele a Claude que conecte tu repositorio

"Connect my GitHub repo https://github.com/username/my-project"

Paso 2: Configura el webhook en GitHub

Claude te dará la Payload URL y el Secret. Añádelos en Settings → Webhooks de tu repositorio.

Paso 3: Activa el webhook

"Activate the webhook for my repo"

Detalles de configuración del webhook

Al añadir el webhook en GitHub, usa estos ajustes:

Ve a tu repositorio → Settings → Webhooks → Add webhook
Pega la Payload URL proporcionada por ContextForge
Establece el Content type como application/json
Pega el Secret proporcionado por ContextForge
En "Which events would you like to trigger this webhook?" selecciona Let me select individual events
Marca Pushes y Pull requests
Haz clic en Add webhook

Consejo:GitHub enviará un "ping" para verificar el webhook. Deberías ver una marca de verificación verde si fue exitoso.

¡Listo! Ya está todo configurado

A partir de ahora, cada git push que hagas (desde cualquier terminal, VS Code o GitHub) se guardará automáticamente en tu memoria. No se requieren pasos adicionales.

Actividad de GitHub en tareas

Cuando los commits y PRs están vinculados a una tarea (mediante la etiqueta issue:<short_id>), aparecen directamente en el dashboard:

Insignia en tarjetas de tarea

Las tarjetas y filas de lista de tareas muestran un icono de GitHub con el número de commits y PRs vinculados. Visible tanto en vista de cuadrícula como de lista.

Sección en la vista de detalle

Al abrir una tarea se muestra una sección "GitHub Activity" con la lista completa de commits y PRs vinculados, incluyendo SHA, autor y enlaces externos.

Cómo funciona el vínculo: cuando el webhook MCP procesa un commit, etiqueta automáticamente el Knowledge Item con issue:<short_id> si el mensaje del commit o el PR hace referencia a una tarea. Estas etiquetas son las que conectan los commits con las tareas en la interfaz.

Gestionar repositorios conectados

Puedes gestionar tus repositorios conectados desde la página de Account en el dashboard. La sección de GitHub Repositories muestra todos los repositorios conectados con su estado de sincronización.

Activar / Pausar sincronización

Activa o desactiva la sincronización por webhook sin eliminar el repositorio.

Ver información del webhook

Accede a la URL y el secret del webhook en cualquier momento para actualizar tu configuración de GitHub.

Abrir en GitHub

Acceso rápido a tu repositorio en GitHub.

Desconectar

Elimina el repositorio y todos los datos sincronizados. No olvides eliminar también el webhook en GitHub.

Consultar tu historial de Git

Una vez que los commits se estén guardando, puedes preguntarle a Claude sobre el historial de tu proyecto:

# Actividad reciente

"What commits did I make today?"

# Por funcionalidad

"Show commits related to authentication"

# Historial de PRs

"What PRs were merged this week?"

# Resúmenes

"Summarize changes in the last sprint"

Importar historial existente

El webhook solo captura commits nuevos después de la configuración. Para importar commits existentes, usa la sincronización manual:

# Importar los últimos 50 commits

"Sync the last 50 commits from my repo"

Nota: la sincronización manual requiere un token de GitHub para repositorios privados. El webhook funciona sin token porque GitHub envía los datos directamente.

Qué se captura

Commits

Mensaje del commit
Nombre y email del autor
Marca de tiempo
Hash SHA
Archivos añadidos/modificados/eliminados
Tipo de commit (feat, fix, docs, etc.)

Pull Requests

Título y descripción del PR
Autor
Estado (opened, merged, closed)
Rama de origen y destino
Etiquetas
Número de commits y cambios

Referencia de herramientas MCP

memory_git_connect

Conecta un repositorio de GitHub para comenzar a rastrear commits y PRs.

Nombre	Tipo	Descripción
repo_url	string	URL de GitHub o formato owner/repo
space_id	string?	Space de destino (crea un Space "Git" si no se especifica)

memory_git_activate

Activa o desactiva el webhook después de configurarlo en GitHub.

Nombre	Tipo	Descripción
repo	string	Repositorio en formato owner/repo
active	boolean	true para activar, false para desactivar

memory_git_sync

Sincroniza manualmente commits y PRs existentes (requiere token de GitHub para repositorios privados).

Nombre	Tipo	Descripción
repo	string	Repositorio en formato owner/repo
sync_type	string?	"commits", "prs" o "all" (predeterminado)
limit	number?	Máximo de elementos a sincronizar (1-100, predeterminado: 30)

memory_git_commits

Lista los commits que se han sincronizado con la memoria.

Nombre	Tipo	Descripción
repo	string?	Filtra por repositorio (opcional)
limit	number?	Máximo de resultados (predeterminado: 50)

memory_git_prs

Lista los pull requests que se han sincronizado con la memoria.

Nombre	Tipo	Descripción
repo	string?	Filtra por repositorio (opcional)
limit	number?	Máximo de resultados (predeterminado: 50)

memory_git_list

Lista todos los repositorios de GitHub conectados.

memory_git_disconnect

Desconecta un repositorio y detiene la sincronización.

Nombre	Tipo	Descripción
repo	string	Repositorio en formato owner/repo

Casos de uso

"¿Qué cambiamos en el último sprint?"
Claude busca en tus commits sincronizados para resumir los cambios recientes
"¿Quién trabajó en el módulo de autenticación?"
Encuentra commits y PRs relacionados con funcionalidades o archivos específicos
"¿Por qué se eligió este enfoque?"
Las descripciones de PRs suelen contener la justificación de las decisiones y el contexto
"Genera las notas de la versión v2.0"
Compila automáticamente los cambios entre versiones

Solución de problemas

El webhook aparece como "failed" en GitHub

Comprueba que la URL del webhook y el secret sean exactamente los proporcionados. El secret distingue mayúsculas y minúsculas.

Los commits no aparecen después de un push

Verifica que el webhook esté activado con memory_git_list. El estado debe ser "active".

La sincronización manual falla con 404

Para repositorios privados, la sincronización manual requiere un token de GitHub. El webhook funciona sin token porque GitHub envía los datos directamente.