Agent Note

Un git commit enregistre ce qui a changé. Agent Note enregistre pourquoi ça a changé.

Pourquoi j’ai créé ça

Il y a six mois, j’ai relu du code que l’IA avait écrit pour moi et je n’ai pas pu répondre à « pourquoi j’ai fait ça comme ça ? ». git log n’avait que le diff. Les prompts, les réponses — tout disparu.

Alors j’ai commencé à attacher la conversation IA à chaque commit.

Ce que ça fait

Garder une trace du travail assisté par l'IA

Voyez quels commits et fichiers viennent d’une aide IA. Quand Agent Note a assez de preuves, il estime aussi les lignes écrites par l’IA.

Prompts et réponses sauvegardés ensemble

Le nom du modèle et l’utilisation des outils aussi — tout regroupé dans les git notes avec le changement.

Rapports PR automatiques

AI Ratio, prompts, hashes de commits, plus un Reviewer Context caché pour les AI Review tools.

Écrit uniquement dans les git notes

Les branches restent propres. Push / fetch pour partager avec l’équipe, avec un Dashboard statique optionnel sur GitHub Pages.

Où aller ensuite

Si vous voulez…	Lisez
Comprendre ce qu’Agent Note ajoute avant l’installation	Démarrage
Installer Agent Note dans un dépôt	Installation
Ajouter le rapport visible dans la PR	GitHub Action
Publier une page partagée pour l’équipe	Dashboard
Vérifier ce que chaque agent peut capturer	Compatibilité des agents
Comprendre ce qui est stocké et visible	Data & Privacy
Corriger des notes, prompts ou données Dashboard manquants	Troubleshooting

Configuration

Lancez init dans votre dépôt
Fenêtre de terminal
```
npx agent-note init --agent claude
```
- Pour Codex CLI : npx agent-note init --agent codex
- Pour Cursor : npx agent-note init --agent cursor
- Pour Gemini CLI : npx agent-note init --agent gemini
- Plusieurs agents à la fois : npx agent-note init --agent claude cursor
Committez les fichiers générés
Fenêtre de terminal
```
git add .claude/settings.json .github/workflows/agentnote-pr-report.yml
git commit -m "chore: enable agent-note"
git push
```
- Codex CLI : versionner .codex/config.toml et .codex/hooks.json
- Cursor : versionner .cursor/hooks.json
- Gemini CLI : versionner .gemini/settings.json
Codez avec l’IA. Une fois les git hooks générés installés, le git commit normal suffit.

Vérifiez votre configuration

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: affiche l’adaptateur actif, capture: résume ce que collectent les hooks actifs, git: indique si les git hooks gérés sont installés, et commit: indique si le git commit normal est la voie principale.

Voyez par vous-même

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 des capacités des agents

Capacité

Claude Code

Codex CLI

Cursor

Gemini CLI

Statut

Prise en charge complète

Pris en charge

Aperçu

Prompt

Oui

Réponse

Oui

Fichiers

Oui

AI Ratio

Oui

Estimation des lignes

Par défaut

L’historique de patch Codex correspond au commit final

Les compteurs d’édition correspondent et le fichier final correspond encore à la dernière édition IA

Pas encore

Pour les détails, consultez Compatibilité des agents.