Git Commit Aider

Faça commits git em nome da IA para rastrear contribuições de IA no seu código.

GitHub
8

Documentação

Servidor MCP git-commit-aider

Faça commits git em nome da IA, para que você possa rastrear a contribuição da IA no seu código.

Este é um servidor MCP baseado em TypeScript que fornece uma ferramenta para commitar alterações em staged em um repositório Git, adicionando "(aider)" ao nome do committer.

Recursos

Este servidor MCP fornece apenas uma ferramenta:

commit_staged - Commita alterações em staged com uma mensagem específica.

  • Recebe message (string, obrigatório) como a mensagem do commit.
  • Recebe cwd (string, opcional) para especificar o diretório de trabalho para o comando git.
  • Adiciona "(aider)" ao nome do committer automaticamente.
  • Lê nome e email do committer a partir das variáveis de ambiente (GIT_COMMITTER_NAME, GIT_COMMITTER_EMAIL) se definidas; caso contrário, usa git config user.name e git config user.email.

Com esta ferramenta instalada no seu editor de código, você pode pedir à IA algo como:

Commit as alterações para mim

Isso geralmente acontece depois que a IA fez algumas alterações no seu código, então muitas vezes a IA consegue fornecer uma boa mensagem de commit a partir do contexto.

Instalação

Para usar este servidor, adicione sua configuração ao seu arquivo de configurações MCP.

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

As informações do committer são recuperadas de:

  1. Variáveis de ambiente GIT_COMMITTER_NAME e GIT_COMMITTER_EMAIL, que seguem a convenção do git.
  2. Saída dos comandos git config user.name e git config user.email.

Alternativa: alterar o autor após o commit

Se você não quiser usar este servidor MCP, também pode usar o comando git diretamente no seu terminal.

Você pode fazer um commit normal primeiro e depois usar o seguinte comando git para alterar o autor do último commit:

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

Isso alterará o autor do último commit para o seu nome com "(aider)" adicionado.

Para simplificar o processo, você pode configurar um alias do Git. Execute o seguinte comando no seu terminal:

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

Depois de configurado, você pode usar o alias executando:

git aimend

Calculando a contribuição da IA

Commits com "(aider)" podem ser capturados pelo comando aider --stats, que mostrará a contribuição da IA no seu código.

Alternativamente, você pode usar o seguinte script para calcular a contribuição da IA no seu código, medida em linhas de código (adicionadas, excluídas e alterações totais).

#!/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"

Exemplo 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
#     }
#   ]
# }

Descrição dos Campos de Saída

A saída JSON contém os seguintes campos:

  • ai_percentage: (Número) A porcentagem do total de linhas alteradas (soma das linhas adicionadas e excluídas) que foram contribuídas por autores de IA (identificados por AI_MATCHER).
  • ai_changes: (Objeto) Um objeto detalhando as mudanças agregadas de linhas (linhas added, deleted e seus total) feitas por autores de IA.
  • human_changes: (Objeto) Um objeto detalhando as mudanças agregadas de linhas (linhas added, deleted e seus total) feitas por autores humanos.
  • details: (Array de Objetos) Fornece um detalhamento das mudanças. Cada objeto no array representa a contribuição de um author específico para um fileName específico, incluindo linhas added, deleted e as alterações total para esse arquivo por esse autor.