コンテンツにスキップ
Agent Note Agent Note

Agent Note

Git Commit は「何が変わったか」を残す。 Agent Note は「なぜそう変わったか」を残す。
はじめる GitHub

なぜ作ったか

半年前に AI に書いてもらったコードを読み返して、「なんでこうした？」が答えられなかった。git log に残っているのは diff だけ。プロンプトも返答も、ぜんぶ消えていた。

だから、AI との会話をコミットに残すことにした。

Agent Note dashboard preview

できること

Section titled “できること”

AI が関わった変更を残す

どのコミットやファイルに AI が関わったかを確認できます。十分な根拠がある場合は、AI が書いた行の目安も表示します。

プロンプトと返答も一緒に保存

モデル名・使ったツール情報も含めて、変更とセットで git notes に入れる。

PR に自動でレポート

AI Ratio、プロンプト数、コミットハッシュに加えて、レビュー支援ツール向けの補足コンテキスト（通常は非表示）も含まれます。

git notes にだけ書く

ブランチには混ざらない。push / fetch でチーム共有しつつ、必要なら GitHub Pages に Dashboard を公開できる。

次に読むページ

Section titled “次に読むページ”
やりたいこと読むページ
Agent Note が何を追加するか先に知るはじめに
repository に Agent Note を入れるインストール
PR に表示される説明を追加するGitHub Action
チームで共有する履歴ページを公開するDashboard
各 coding agent で何を取得できるか確認するエージェント対応
保存されるデータと見える範囲を確認するデータとプライバシー
notes、prompt、Dashboard の表示を直すTroubleshooting

セットアップ

Section titled “セットアップ”

  1. リポジトリで init を実行

    Terminal window
    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. 生成されたファイルをコミット

    Terminal window
    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 hook が入っていれば、通常の git commit をそのまま使えます。

セットアップ確認

Section titled “セットアップ確認”
Terminal window
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: は有効な adapter、capture: は今の hook が何を集めるか、git: は管理対象の git hook が入っているか、commit: は通常の git commit が主経路かどうかを示します。

実際の表示

Section titled “実際の表示”
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  👤

エージェント別サポート状況

Section titled “エージェント別サポート状況”
機能
Claude Code
Codex CLI
Cursor
Gemini CLI
状態
完全対応
対応
対応
プレビュー
プロンプト
対応
対応
対応
対応
応答
対応
対応
対応
対応
ファイル
対応
対応
対応
対応
AI Ratio
対応
対応
対応
対応
行数推定
既定で表示
Codex patch 履歴が最終 commit と一致したとき
edit 数が一致し、committed file が最後の AI edit と一致したとき
未対応

詳しくは エージェント対応 を参照してください。