명령어

이 페이지는 사용자가 직접 실행하는 command 만 다룹니다. 첫 setup 은 설치 에서 시작하세요.

자주 쓰는 작업

• 첫 setup: agent-note init
• repository 에서 Agent Note 제거: agent-note deinit
• 상태 확인: agent-note status
• 최근 활동 확인: agent-note log
• commit 데이터 보기: agent-note show
• 한 줄이 왜 바뀌었는지 확인: agent-note why

참고

PR Report 와 Dashboard 는 GitHub Actions 기능입니다. agent-note init 은 보통 workflow 파일을 만들고, 실제 report 와 Dashboard 는 이후 workflow 실행으로 생성됩니다.

agent-note init

repository 에 Agent Note 를 설정합니다.

npx agent-note init --agent claude

Flag	설명
--agent <name...>	하나 이상의 agent adapter 를 선택합니다: claude, codex, cursor or gemini
--dashboard	공유 Dashboard workflow 도 생성합니다
--no-hooks	agent hook 설정을 건너뜁니다
--no-git-hooks	Git Hooks 설치를 건너뜁니다
--no-action	workflow 생성을 건너뜁니다
--no-notes	notes auto-fetch 설정을 건너뜁니다
--hooks	agent hooks 만 설치합니다
--action	workflow 만 생성합니다

agent-note deinit

하나 이상의 Agent hooks 와 config 를 제거합니다.

npx agent-note deinit --agent claude

Flag	설명
--agent <name...>	claude, codex, cursor or gemini
--remove-workflow	PR Report 와 Dashboard workflow 도 제거
--keep-notes	notes auto-fetch 설정 유지

agent-note status

추적 상태를 보여줍니다.

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-note log

최근 commit 과 AI Ratio 를 표시합니다.

npx agent-note log
npx agent-note log 20

ce941f7 feat: add auth  [a1b2c3d4… | 🤖60% | 2p]
326a568 test: add tests [a1b2c3d4… | 🤖100% | 1p]
ba091be fix: update deps

agent-note show

commit 의 AI Session 을 보여줍니다.

npx agent-note show
npx agent-note show abc1234

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  👤

prompts: 2

  1. Implement JWT auth middleware with refresh token rotation
  2. Add tests for expired token and invalid signature

agent-note why

변경된 줄 뒤의 Agent Note context 를 보여줍니다.

npx agent-note why src/middleware/auth.ts:42
npx agent-note why src/middleware/auth.ts:42-55
npx agent-note why src/middleware/auth.ts:42:7
npx agent-note why src/middleware/auth.ts#L42
npx agent-note why src/middleware/auth.ts#L42-L55
npx agent-note why src/middleware/auth.ts#L42C7
npx agent-note why @src/middleware/auth.ts#L42
npx agent-note why https://github.com/owner/repo/blob/main/src/middleware/auth.ts#L42
npx agent-note why file:///workspace/repo/src/middleware/auth.ts#L42
npx agent-note why vscode://file/workspace/repo/src/middleware/auth.ts:42:7

참고

why 는 path:line, path#Lline, GitHub file URL, file://..., vscode://file..., AI Agent 출력에서 복사한 앞쪽 @ path 를 받습니다.

Agent Note Skill

Agent Note Skill 을 설치하면 자연어로 이런 작업을 요청할 수 있습니다.

gh skill install wasabeef/AgentNote agent-note --agent codex --scope user

gh skill install 의 --agent 에는 Agent 에 맞는 identifier 인 codex, claude-code, cursor or gemini-cli 를 지정하세요.