Agent Note

Un git commit registra cosa è cambiato. Agent Note registra perché è cambiato.

Perché l’ho creato

Sei mesi fa ho riletto del codice che l’IA aveva scritto per me e non riuscivo a rispondere “perché l’ho fatto così?”. git log aveva solo il diff. I prompt, le risposte — tutto sparito.

Così ho iniziato ad allegare la conversazione con l’IA a ogni commit.

Cosa fa

Tenere traccia del lavoro assistito dall'IA

Vedi quali commit e file hanno ricevuto aiuto dall’IA. Quando Agent Note ha prove sufficienti, stima anche le righe scritte dall’IA.

Prompt e risposte salvati insieme

Anche il nome del modello e l’uso degli strumenti — tutto raggruppato in git notes con la modifica.

Report PR automatici

AI Ratio, prompt, hash dei commit e Reviewer Context nascosto per gli AI Review tools.

Scritto solo nelle git notes

I branch rimangono puliti. Push / fetch per condividere con il team, con una Dashboard statica opzionale su GitHub Pages.

Dove andare dopo

Se vuoi…	Leggi
Capire cosa aggiunge Agent Note prima dell’installazione	Primi passi
Installare Agent Note in un repository	Installazione
Aggiungere il report visibile nella PR	GitHub Action
Pubblicare una vista condivisa per il team	Dashboard
Controllare cosa può acquisire ogni agente	Supporto degli agenti
Capire cosa viene salvato e chi può vederlo	Data & Privacy
Risolvere note, prompt o dati Dashboard mancanti	Troubleshooting

Configurazione

Esegui init nel tuo repository
Terminal window
```
npx agent-note init --agent claude
```
- Per Codex CLI: npx agent-note init --agent codex
- Per Cursor: npx agent-note init --agent cursor
- Per Gemini CLI: npx agent-note init --agent gemini
- Più agenti contemporaneamente: npx agent-note init --agent claude cursor
Committa i file generati
Terminal window
```
git add .claude/settings.json .github/workflows/agentnote-pr-report.yml
git commit -m "chore: enable agent-note"
git push
```
- Codex CLI: versionare .codex/config.toml e .codex/hooks.json
- Cursor: versionare .cursor/hooks.json
- Gemini CLI: versionare .gemini/settings.json
Codifica con l’IA. Se i git hook generati sono installati, ti basta usare il normale git commit.

Verifica la configurazione

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: mostra l’adattatore attivo, capture: riassume cosa raccolgono gli hook attivi, git: mostra se i git hook gestiti sono installati, e commit: indica se il normale git commit è il percorso principale.

Guardalo in azione

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  👤

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

## 🧑💬🤖 Agent Note

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

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

Matrice delle capacità degli agenti

Capacità

Claude Code

Codex CLI

Cursor

Gemini CLI

Stato

Supporto completo

Supportato

Anteprima

Prompt

Sì

Risposta

Sì

File

Sì

AI Ratio

Sì

Stima righe

Di default

La cronologia patch di Codex corrisponde al commit finale

I conteggi delle modifiche coincidono e il file finale corrisponde ancora all’ultima modifica IA

Non ancora

Per i dettagli, consulta Supporto degli agenti.