Supporto agent

Agent Note usa lo stesso formato di git note per tutti gli agent, ma ogni agent espone hook e transcript diversi. Questa pagina chiarisce cosa aspettarsi prima di abilitarlo per un team.

Matrice delle capacità degli Agent

Agent	Stato	Prompt	Response	Files	AI Ratio	Line Estimate
Claude Code	Full support	Sì	Sì	Sì	Sì	Di default
Codex CLI	Supported	Sì	Sì	Sì	Sì	Quando la cronologia patch di Codex corrisponde al Commit finale
Cursor	Supported	Sì	Sì	Sì	Sì	Quando i conteggi degli edit coincidono e il file finale corrisponde ancora all’ultimo edit IA
Gemini CLI	Preview	Sì	Sì	Sì	Sì	Non ancora

Nota

Files significa che Agent Note può mostrare quali file committati sono stati toccati dall’Agent. Line Estimate significa che può anche stimare le linee scritte dall’AI invece di contare solo i file. Preview significa che Agent Note supporta il comportamento pubblico attuale, ma il formato locale dell’agent può ancora cambiare.

Setup consigliato

npx agent-note init --agent claude

Abilita solo gli agent che il team usa davvero. Più agent possono convivere nello stesso repository.

npx agent-note init --agent claude codex cursor gemini

Ogni developer deve eseguire init una volta dopo il clone, perché i git hooks vivono in .git/.

Scegliere in base alle aspettative

Ti serve…	Aspettati…
L’attribution riga per riga più completa oggi	Claude Code
Supporto Codex CLI con attribution prudente	Codex CLI
Cronologia editor Cursor e recupero delle response	Cursor
Capture prompt / response con Gemini CLI	Gemini CLI

Attribution

Line-level conta le linee aggiunte dall’IA quando Agent Note può confrontare edit IA, edit umani successivi e diff finale. File-level si usa quando questa prova non è sicura.

Agent Note preferisce un fallback conservativo a un risultato indovinato.

Note per agent

Claude Code

Claude Code fornisce prompt, response ed edit tramite hook. Agent Note salva lo stato dei file prima e dopo l’edit IA e sottrae gli edit umani successivi.

Codex CLI

Codex CLI è transcript-driven. Agent Note legge transcript locali e passa a line-level solo quando i conteggi apply_patch coincidono con il diff finale.

Cursor

Cursor usa afterFileEdit / afterTabFileEdit, più response hooks o transcript locali. Line-level è possibile solo se i conteggi degli edit coincidono e il file finale corrisponde ancora all’ultimo edit IA.

Gemini CLI

Gemini CLI usa BeforeTool / AfterTool per i file e BeforeAgent / AfterAgent per prompt / response. L’attribution resta file-level.

Dati mancanti

• Nessuna note per commit senza file AI-authored.
• Un prompt vecchio può essere omesso se appartiene a un’altra finestra di commit.
• Una response può mancare se l’agent non la espone.
• Gli artefatti generati e i path elencati nella .agentnoteignore nella root del repository restano visibili in Notes, PR Report e Dashboard; vengono esclusi solo dal denominatore dell’AI Ratio.

Per investigare, parti da Troubleshooting.