Git Commit Aider

Realiza commits de git en nombre de la IA para rastrear las contribuciones de la IA en tu código base.

GitHub
8
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Git Commit Aider

Realiza commits de git en nombre de la IA, para que puedas rastrear la contribución de la IA en tu código base.

Este es un servidor MCP basado en TypeScript que proporciona una herramienta para commitear cambios en el área de preparación en un repositorio Git, añadiendo "(aider)" al nombre del committer.

Características

Este servidor MCP ofrece únicamente una herramienta:

commit_staged - Commitear los cambios preparados con un mensaje específico.

  • Toma message (cadena, obligatorio) como mensaje del commit.
  • Toma cwd (cadena, opcional) para especificar el directorio de trabajo para el comando git.
  • Añade "(aider)" automáticamente al nombre del committer.
  • Lee el nombre y el correo del committer desde las variables de entorno (GIT_COMMITTER_NAME, GIT_COMMITTER_EMAIL) si están definidas, de lo contrario utiliza git config user.name y git config user.email.

Con esta herramienta instalada en tu editor de código, puedes pedirle a la IA algo como:

Commitear los cambios por mí

Esto normalmente ocurre después de que la IA ha realizado algunos cambios en tu código base, por lo que a menudo la IA puede proporcionar un buen mensaje de commit a partir del contexto.

Instalación

Para usar este servidor, agrega su configuración a tu archivo de ajustes de MCP.

{
  "mcpServers": {
    "git-commit-aider": {
      "command": "npx",
      "args": ["mcp-git-commit-aider"]
    }
  }
}

La información del committer se obtiene de:

  1. Variables de entorno GIT_COMMITTER_NAME y GIT_COMMITTER_EMAIL, lo cual sigue la convención de git.
  2. La salida de los comandos git config user.name y git config user.email.

Alternativa: modificar el autor después del commit

Si no deseas usar este servidor MCP, también puedes usar el comando git directamente en tu terminal.

Puedes proceder con un commit normal primero y luego usar el siguiente comando git para cambiar el autor del último commit:

git commit --amend --author="$(git config user.name) (aider) <$(git config user.email)>"

Esto cambiará el autor del último commit a tu nombre con "(aider)" añadido.

Para simplificar el proceso, puedes configurar un alias de Git. Ejecuta el siguiente comando en tu terminal:

git config --global alias.aimend '!git commit --amend --author="$(git config user.name) (aider) <$(git config user.email)>"'

Una vez configurado, puedes usar el alias ejecutando:

git aimend

Cálculo de la contribución de la IA

Los commits con "(aider)" pueden ser recogidos por el comando aider --stats, que te mostrará la contribución de la IA en tu código base.

Alternativamente, puedes usar el siguiente script para calcular la contribución de la IA en tu código base, medida en líneas de código (agregadas, eliminadas y cambios totales).

#!/bin/bash

# Script to calculate line changes (added, deleted, total) by AI and human authors
# between two commits.
# Output is in JSON format.
#
# This logic is extracted and altered from git-quick-stats.sh, MIT license.

# --- Configuration ---
# You may change the config to match your repository's convention.

# String to identify AI-generated commits in author names
AI_MATCHER="(aider)"

# Define patterns for files/paths to be excluded from the calculation.
# These will be converted to git pathspecs like ":(exclude)*package-lock.json"
IGNORE_PATTERNS=(
  "*package-lock.json"
  "*.lock"
)

# --- Helper Functions ---
function print_usage() {
  echo "Usage: $0 <REVISION_RANGE>"
  echo "  <REVISION_RANGE>: The revision range to analyze (e.g., HEAD~5..HEAD, my-branch, commit_sha)."
  echo "  Refer to 'git help log' or 'git help revisions' for more range options."
  echo "Example: $0 HEAD~5..HEAD"
  echo "Example: $0 origin..HEAD"
  echo "Example: $0 my-feature-branch"
  echo "Example: $0 abcdef1..fedcba2"
}

# --- Argument Parsing ---
if [ "$#" -ne 1 ]; then
  echo "Error: Incorrect number of arguments. Please provide a single revision range."
  print_usage
  exit 1
fi

REVISION_RANGE="$1"

# --- Main Logic ---

# Construct pathspec arguments for git log
pathspec_args=()
for pattern in "${IGNORE_PATTERNS[@]}"; do
  pathspec_args+=(":(exclude)$pattern")
done

git_log_output=$(git log "$REVISION_RANGE" --numstat --pretty="format:AuthorName:%an" -- "${pathspec_args[@]}")

# DEBUG: Uncomment to check the calculation for each commit.
# echo "$git_log_output"

# Process the log output with awk
result_json=$(echo "$git_log_output" | awk -v ai_matcher="$AI_MATCHER" '
BEGIN {
  ai_added = 0
  ai_deleted = 0
  human_added = 0
  human_deleted = 0
  current_author = ""
  is_ai_author = 0
}

/^AuthorName:/ {
  # Extract author name
  current_author = substr($0, length("AuthorName:") + 1)
  if (index(current_author, ai_matcher) > 0) {
    is_ai_author = 1
  } else {
    is_ai_author = 0
  }
  next
}

# Skip empty lines between commit blocks or lines that are not numstat
NF == 0 || !($1 ~ /^[0-9]+$/ && $2 ~ /^[0-9]+$/) {
  next
}

# Process numstat line: <added> <deleted> <file>
{
  added_lines = $1
  deleted_lines = $2

  # Skip binary files where numstat shows "-" for lines
  if (added_lines == "-" || deleted_lines == "-") {
    next
  }

  # Aggregate stats per author and file for details array
  file_name = $3
  # Robust key using File Separator character \034
  key = current_author "\034" file_name

  file_author_added[key] += added_lines
  file_author_deleted[key] += deleted_lines

  if (is_ai_author) {
    ai_added += added_lines
    ai_deleted += deleted_lines
  } else {
    human_added += added_lines
    human_deleted += deleted_lines
  }
}

END {
  ai_total_changed = ai_added + ai_deleted
  human_total_changed = human_added + human_deleted
  overall_total_changed = ai_total_changed + human_total_changed
  ai_percentage = 0.00

  if (overall_total_changed > 0) {
    ai_percentage = (ai_total_changed / overall_total_changed) * 100
  }

  printf "{\n"
  printf "  \"ai_percentage\": %.2f,\n", ai_percentage
  printf "  \"ai_changes\": {\"added\": %d, \"deleted\": %d, \"total\": %d},\n", ai_added, ai_deleted, ai_total_changed
  printf "  \"human_changes\": {\"added\": %d, \"deleted\": %d, \"total\": %d},\n", human_added, human_deleted, human_total_changed

  # Details array
  printf "  \"details\": [\n"
  first_detail = 1
  # Iterate over one of the arrays, keys should be consistent
  for (key in file_author_added) {
    if (!first_detail) {
      printf ",\n"
    }
    first_detail = 0

    # Split key "author\034fileName" into key_parts array
    # key_parts[1] will be author, key_parts[2] will be fileName
    split(key, key_parts, "\034")
    author = key_parts[1]
    fileName = key_parts[2]

    # Escape double quotes for JSON compatibility
    gsub(/"/, "\\\"", author)
    gsub(/"/, "\\\"", fileName)

    detail_added = file_author_added[key] + 0 # Ensure numeric
    detail_deleted = file_author_deleted[key] + 0 # Ensure numeric
    detail_total = detail_added + detail_deleted

    printf "    {\n"
    printf "      \"fileName\": \"%s\",\n", fileName
    printf "      \"author\": \"%s\", \"isAI\": %s,\n", author, (index(author, ai_matcher) > 0 ? "true" : "false")
    printf "      \"added\": %d, \"deleted\": %d, \"total\": %d\n", detail_added, detail_deleted, detail_total
    printf "    }"
  }
  printf "\n  ]\n"
  printf "}\n"
}
')

# --- Output ---
echo "$result_json"

Ejemplo de uso:

# Assume the script is saved as `calculate_ai_contribution.sh` and is executable (chmod +x calculate_ai_contribution.sh)

# Example 1: Analyze the last 5 commits
./calculate_ai_contribution.sh HEAD~5..HEAD

# Example 2: Analyze commits between a specific commit and HEAD
./calculate_ai_contribution.sh 90a5fcd4..HEAD

# Example 3: Analyze all commits on a feature branch not yet in main
./calculate_ai_contribution.sh main..my-feature-branch

# Example 4: Analyze commits between two tags
./calculate_ai_contribution.sh v1.0..v1.1

# Example output (will vary based on your repository and range):
# {
#   "ai_percentage": 48.53,
#   "ai_changes": { "added": 100, "deleted": 32, "total": 132 },
#   "human_changes": { "added": 103, "deleted": 37, "total": 140 },
#   "details": [
#     {
#       "fileName": "src/featureA.js",
#       "author": "Developer One (aider)", "isAI": true,
#       "added": 60, "deleted": 10, "total": 70
#     },
#     {
#       "fileName": "src/featureB.js",
#       "author": "Developer One (aider)", "isAI": true,
#       "added": 40, "deleted": 22, "total": 62
#     },
#     {
#       "fileName": "src/utils.js",
#       "author": "Developer Two", "isAI": false,
#       "added": 80, "deleted": 15, "total": 95
#     },
#     {
#       "fileName": "README.md",
#       "author": "Developer Two", "isAI": false,
#       "added": 23, "deleted": 22, "total": 45
#     }
#   ]
# }

Descripción de los Campos de Salida

La salida JSON contiene los siguientes campos:

  • ai_percentage: (Número) El porcentaje del total de líneas cambiadas (suma de líneas agregadas y eliminadas) que fueron contribuidas por autores de IA (identificados por AI_MATCHER).
  • ai_changes: (Objeto) Un objeto que detalla los cambios de líneas agregados (líneas added, deleted y su total) realizados por autores de IA.
  • human_changes: (Objeto) Un objeto que detalla los cambios de líneas agregados (líneas added, deleted y su total) realizados por autores humanos.
  • details: (Arreglo de Objetos) Proporciona un desglose detallado de los cambios. Cada objeto en el arreglo representa la contribución de un author específico a un fileName particular, incluyendo líneas added, deleted y los cambios total para ese archivo por ese autor.