Agent Note

Por qué lo construí

Hace seis meses volví a leer código que la IA había escrito para mí y no pude responder “¿por qué lo hice así?”. git log solo tenía el diff. Los prompts, las respuestas — todo desaparecido.

---

Así que empecé a adjuntar la conversación con la IA a cada commit.

Qué hace

Registrar el trabajo asistido por IA

Ve qué commits y archivos recibieron ayuda de IA. Cuando Agent Note tiene evidencia suficiente, también estima las líneas escritas por IA.

Prompts y respuestas guardados junto al cambio

Nombre del modelo y uso de herramientas también — todo empaquetado en git notes con el cambio.

Reportes automáticos en PR

AI Ratio, prompts, hashes de commits y Reviewer Context oculto para AI Review tools.

Escrito solo en git notes

Las ramas se mantienen limpias. Push / fetch para compartir con el equipo y un Dashboard estático opcional en GitHub Pages.

Qué leer después

Si quieres…	Lee
Entender qué añade Agent Note antes de instalarlo	Primeros pasos
Instalar Agent Note en un repositorio	Instalación
Añadir el reporte que verá la PR	GitHub Action
Publicar una vista compartida para el equipo	Dashboard
Ver qué puede capturar cada agente	Soporte de agentes
Entender qué se guarda y quién puede verlo	Data & Privacy
Corregir notas, prompts o datos de Dashboard faltantes	Troubleshooting

Configuración

1. Ejecuta init en tu repositorio

   npx agent-note init --agent claude

   • Para Codex CLI: npx agent-note init --agent codex
   • Para Cursor: npx agent-note init --agent cursor
   • Para Gemini CLI: npx agent-note init --agent gemini
   • Varios agentes a la vez: npx agent-note init --agent claude cursor

2. Haz commit de los archivos generados

   git add .claude/settings.json .github/workflows/agentnote-pr-report.yml
   git commit -m "chore: enable agent-note"
   git push

   • Codex CLI: versionar .codex/config.toml y .codex/hooks.json
   • Cursor: versionar .cursor/hooks.json
   • Gemini CLI: versionar .gemini/settings.json

3. Codifica con IA. Con los git hooks generados instalados, basta con usar git commit normalmente.

Verifica tu configuración

npx agent-note status

agent-note v1.x.x

agent:   active (cursor)
capture: cursor(prompt, response, edits, shell)
git:     active (prepare-commit-msg, post-commit, pre-push)
commit:  tracked via git hooks
session: a1b2c3d4…
agent:   cursor
linked:  3/20 recent commits

agent: muestra el adaptador activo, capture: resume lo que recopilan los hooks activos, git: muestra si los git hooks administrados están instalados, y commit: indica si el git commit normal es la ruta principal.

Míralo en acción

agent-note show

commit:  ce941f7 feat: add JWT auth middleware
session: a1b2c3d4-5678-4abc-8def-111122223333

ai:      60% (45/75 lines) [█████░░░]
model:   claude-sonnet-4-20250514
agent:   claude
files:   3 changed, 2 by AI

  src/middleware/auth.ts  🤖
  src/types/token.ts  🤖
  CHANGELOG.md  👤

agent-note log

ce941f7 feat: add auth  [a1b2c3d4… | 🤖60% | 2p]
326a568 test: add tests [a1b2c3d4… | 🤖100% | 1p]
ba091be fix: update deps

PR Report

## 🧑💬🤖 Agent Note

**Total AI Ratio:** ████████ 73%
**Model:** `claude-sonnet-4-20250514`

| Commit | AI Ratio | Prompts | Files |
|---|---|---|---|
| ce941f7 feat: add auth | ████░ 73% | 2 | auth.ts 🤖 |

Matriz de capacidades de agentes

Capacidad

Claude Code

Codex CLI

Cursor

Gemini CLI

Estado

Soporte completo

Compatible

Compatible

Vista previa

Prompt

Sí

Sí

Sí

Sí

Respuesta

Sí

Sí

Sí

Sí

Archivos

Sí

Sí

Sí

Sí

AI Ratio

Sí

Sí

Sí

Sí

Estimación de líneas

Por defecto

El historial de parches de Codex coincide con el commit final

Los conteos de edición coinciden y el archivo final aún coincide con la última edición de IA

Todavía no

Para más detalles, consulta Soporte de agentes.