Agent Note

Um git commit registra o que mudou. Agent Note registra por que mudou.

Por que eu criei isso

Seis meses atrás reli um código que a IA havia escrito para mim e não consegui responder “por que eu fiz assim?”. git log tinha apenas o diff. Os prompts, as respostas — tudo havia sumido.

Então comecei a anexar a conversa com a IA a cada commit.

O que faz

Registrar o trabalho assistido por IA

Veja quais commits e arquivos tiveram ajuda de IA. Quando o Agent Note tem evidência suficiente, ele também estima as linhas escritas por IA.

Prompts e respostas salvos junto

Nome do modelo e uso de ferramentas também — tudo agrupado em git notes com a mudança.

Relatórios automáticos de PR

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

Escrito apenas em git notes

Branches ficam limpos. Push / fetch para compartilhar com o time, com Dashboard estático opcional no GitHub Pages.

Para onde ir depois

Se você quer…	Leia
Entender o que o Agent Note adiciona antes da instalação	Primeiros passos
Instalar o Agent Note em um repositório	Instalação
Adicionar o relatório que aparece na PR	GitHub Action
Publicar uma página compartilhada para o time	Dashboard
Ver o que cada agente consegue capturar	Suporte a Agentes
Entender o que é salvo e quem pode ver	Data & Privacy
Corrigir notes, prompts ou dados de Dashboard ausentes	Troubleshooting

Configuração

Execute init no seu repositório
Terminal window
```
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
- Vários agentes ao mesmo tempo: npx agent-note init --agent claude cursor
Faça commit dos arquivos gerados
Terminal window
```
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 e .codex/hooks.json
- Cursor: versionar .cursor/hooks.json
- Gemini CLI: versionar .gemini/settings.json
Codifique com IA. Quando os git hooks gerados estão instalados, basta continuar usando git commit.

Verifique sua configuração

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 o adaptador ativo, capture: resume o que os hooks ativos coletam, git: mostra se os git hooks gerenciados estão instalados, e commit: indica se o git commit normal é o caminho principal.

Veja em ação

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 🤖 |

Matriz de capacidades dos agentes

Capacidade

Claude Code

Codex CLI

Cursor

Gemini CLI

Status

Suporte completo

Suportado

Prévia

Prompt

Sim

Resposta

Sim

Arquivos

Sim

AI Ratio

Sim

Estimativa de linhas

Por padrão

O histórico de patches do Codex bate com o commit final

A contagem de edições coincide e o arquivo final ainda bate com a última edição da IA

Ainda não

Para detalhes, veja Suporte a Agentes.