Agent Note

Почему я это сделал

Полгода назад я перечитывал код, который ИИ написал для меня, и не мог ответить «почему я сделал это именно так?». git log хранил только diff. Промпты, ответы — всё исчезло.

---

Поэтому я начал прикреплять разговор с ИИ к каждому коммиту.

Что он делает

Сохранять работу, сделанную с помощью ИИ

Видно, какие коммиты и файлы были изменены с помощью ИИ. Когда доказательств достаточно, Agent Note также оценивает строки, написанные ИИ.

Промпты и ответы сохраняются рядом

Также имя модели и использование инструментов — всё собрано в git notes вместе с изменением.

Автоматические отчёты в PR

AI Ratio, промпты, хеши коммитов и дополнительный контекст для AI-ревью в PR.

Записывается только в git notes

Ветки остаются чистыми. Push / fetch для совместного использования командой, плюс опциональный статический Dashboard на GitHub Pages.

Куда перейти дальше

Если нужно…	Читайте
Понять, что Agent Note добавляет перед установкой	Начало работы
Установить Agent Note в репозиторий	Установка
Добавить отчёт, который виден в PR	GitHub Action
Опубликовать общую страницу истории для команды	Dashboard
Проверить, что может записывать каждый агент	Поддержка агентов
Понять, что сохраняется и кто это видит	Data & Privacy
Исправить отсутствующие notes, prompts или данные Dashboard	Troubleshooting

Настройка

1. Запустите init в вашем репозитории

   npx agent-note init --agent claude

   • Для Codex CLI: npx agent-note init --agent codex
   • Для Cursor: npx agent-note init --agent cursor
   • Для Gemini CLI: npx agent-note init --agent gemini
   • Несколько агентов одновременно: npx agent-note init --agent claude cursor

2. Закоммитьте сгенерированные файлы

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

   • Codex CLI: закоммитить .codex/config.toml и .codex/hooks.json
   • Cursor: закоммитить .cursor/hooks.json
   • Gemini CLI: закоммитить .gemini/settings.json

3. Пишите код с ИИ. Если сгенерированные git hooks установлены, достаточно обычного git commit.

Проверьте настройку

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: показывает активный адаптер, capture: суммирует, что собирают активные hooks, git: показывает, установлены ли управляемые git hooks, а commit: указывает, является ли обычный git commit основным путём.

Посмотрите в действии

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

Матрица возможностей агентов

Возможность

Claude Code

Codex CLI

Cursor

Gemini CLI

Статус

Полная поддержка

Поддерживается

Поддерживается

Предпросмотр

Промпт

Да

Да

Да

Да

Ответ

Да

Да

Да

Да

Файлы

Да

Да

Да

Да

AI Ratio

Да

Да

Да

Да

Оценка строк

По умолчанию

История patch в Codex совпадает с итоговым commit

Счётчики правок совпадают, а итоговый файл всё ещё соответствует последней правке ИИ

Пока нет

Подробности смотрите в Поддержке агентов.