콘텐츠로 이동
Agent Note Agent Note

Agent Note

git commit은 무엇이 바뀌었는지를 기록한다. Agent Note는 왜 바뀌었는지를 기록한다.
시작하기 GitHub

왜 만들었나

반년 전에 AI가 써준 코드를 다시 읽으면서 “왜 이렇게 했지?”라는 질문에 답할 수 없었다. git log에는 diff만 남아 있었다. 프롬프트도, 응답도 — 전부 사라져 있었다.

그래서 AI와의 대화를 모든 커밋에 붙이기 시작했다.

Agent Note dashboard preview

하는 일

섹션 제목: “하는 일”

AI가 도운 변경을 기록으로 남기기

어떤 커밋과 파일에 AI의 도움이 있었는지 확인합니다. 근거가 충분하면 AI가 작성한 줄의 추정치도 표시합니다.

프롬프트와 응답도 함께 저장

모델명과 도구 사용 이력까지 — 변경 사항과 함께 git notes에 묶어 넣는다.

PR 자동 리포트

AI Ratio, 프롬프트 수, 커밋 해시와 함께 AI Review tool 이 읽을 수 있는 숨겨진 보조 Context 도 담습니다.

git notes에만 기록

브랜치는 깨끗하게 유지된다. push / fetch로 팀과 공유하고, 선택적으로 GitHub Pages에 static Dashboard를 공개할 수 있다.

다음에 볼 페이지

섹션 제목: “다음에 볼 페이지”
하고 싶은 일읽을 페이지
설치 전에 Agent Note 가 무엇을 추가하는지 이해하기시작하기
repository 에 Agent Note 설치하기설치
PR 에 보이는 report 추가GitHub Action
팀용 공유 화면 공개Dashboard
각 agent 가 무엇을 기록할 수 있는지 확인Agent 지원
저장되는 데이터와 보이는 범위 확인Data & Privacy
notes, prompt, Dashboard 데이터 문제 해결Troubleshooting

설정

섹션 제목: “설정”

  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. AI와 함께 코딩하세요. 생성된 git hook 이 설치되어 있으면 평소처럼 git commit 을 쓰면 됩니다.

설정 확인

섹션 제목: “설정 확인”
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 이 주 경로인지 보여줍니다.

직접 확인해 보세요

섹션 제목: “직접 확인해 보세요”
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 기능 매트릭스

섹션 제목: “Agent 기능 매트릭스”
기능
Claude Code
Codex CLI
Cursor
Gemini CLI
상태
완전 지원
지원
지원
미리보기
프롬프트
지원
지원
지원
지원
응답
지원
지원
지원
지원
파일
지원
지원
지원
지원
AI Ratio
지원
지원
지원
지원
라인 추정
항상 표시
Codex patch 기록이 최종 Commit 과 일치할 때
edit count 가 맞고 final file 이 마지막 AI edit 와 일치할 때
아직 없음

자세한 내용은 Agent 지원 을 참고하세요.