GitHub 연동

GitHub를 연결하면 저장소에 푸시된 커밋을 AI가 요약해 MashNote 활동으로 기록합니다. 커밋 하나가 활동 하나가 되며, 요약은 기본적으로 영어로 작성되고 커밋 메시지가 한국어이면 한국어로 작성됩니다.

연결하는 곳은 두 군데입니다.

	워크스페이스 연결	개인 연결
여는 곳	워크스페이스 설정 → 연동 → GitHub	개인 설정 → 연동 → GitHub
하는 일	저장소 커밋을 이 워크스페이스의 활동 피드로 받습니다.	내 GitHub 계정을 연결하고(내 계정), 내 저장소의 커밋을 내 매시로 가져옵니다(내 저장소).
기록되는 커밋	이 워크스페이스로 수신하는 저장소: 누가 푸시했든 모든 커밋	내가 작성한 커밋만
기록 위치	이 워크스페이스의 활동	내 매시 (규칙에 따라 워크스페이스에도)

워크스페이스에 GitHub 연결하기

워크스페이스 설정 → 연동을 엽니다. GitHub 카드에 저장소 활동(커밋 푸시)을 이 워크스페이스의 활동 피드로 받아옵니다라고 표시됩니다.
GitHub 연결을 선택합니다. GitHub의 앱 설치 화면으로 이동합니다.
설치할 계정이나 조직과 저장소를 고르고 승인합니다.
MashNote로 돌아오면 GitHub 카드에 설치한 계정과 저장소 목록이 표시됩니다.

저장소 목록이 바로 보이지 않으면 저장소 목록을 동기화하는 중이에요. 잠시 후 새로고침해 주세요.라고 표시됩니다. GitHub 앱이 접근할 수 있는 저장소를 바꾸려면 저장소 추가·변경을 선택합니다.

각 저장소 옆에 이 워크스페이스에서 커밋을 어떻게 받는지 표시됩니다.

표시	의미
이 워크스페이스로 수신	이 워크스페이스에 연결된 저장소입니다. 누가 푸시했든 모든 커밋이 이 워크스페이스의 활동에 기록됩니다. 해제로 연결을 끊을 수 있습니다.
기본 수신 중	따로 연결하지 않은 저장소입니다. GitHub를 연결한 사람의 개인 저장소처럼 처리되어, 연결한 사람이 작성한 커밋만 기록되고 그 사람의 GitHub (내 저장소) 규칙에 따라 기록 위치가 정해집니다.
이 워크스페이스로 받기 / 이 워크스페이스로 옮기기	선택하면 그 저장소를 이 워크스페이스에 연결합니다. 다른 워크스페이스에 연결되어 있던 저장소는 이 워크스페이스로 옮겨집니다.

이 워크스페이스로 수신하는 저장소의 커밋은 작성자의 GitHub 계정이 MashNote 계정과 연결되어 있고 그 사람이 이 워크스페이스의 구성원이면 그 사람의 활동으로 표시됩니다. 팀원에게 내 GitHub 계정 연결하기를 안내하세요.

개인 설정 → 연동의 GitHub 카드(내 커밋과 저장소 활동을 매시노트에 연결해요)는 두 부분으로 되어 있습니다. 내 저장소의 커밋을 내 매시에 모으려면 두 가지를 모두 연결하세요.

내 계정은 커밋과 활동을 내 계정으로 인식하는 데 쓰입니다.

GitHub으로 인증(권장): GitHub에서 로그인해 계정을 확인합니다. 상태가 @{사용자명} · 인증됨으로 표시되고, 이전에 내 것으로 인식되지 않았던 활동도 내 활동으로 가져옵니다. 이때 연결됐어요. 이전 활동 {count}건을 내 활동으로 가져왔어요.라고 표시됩니다.
GitHub 사용자명을 입력하고 등록: 상태가 미인증으로 표시되며, 앞으로 들어오는 활동에만 적용됩니다. 나중에 GitHub으로 인증으로 확인할 수 있습니다.

사용자명을 바꾸려면 변경, 연결을 끊으려면 해제를 선택합니다. 다른 계정에 이미 연결된 사용자명은 이미 다른 계정에 연결된 GitHub 사용자명이에요.라고 표시되며 등록할 수 없습니다.

내 저장소는 내 GitHub 계정의 저장소 커밋을 내 매시로 가져옵니다.

저장소 연결을 선택합니다. GitHub의 앱 설치 화면으로 이동합니다.
커밋을 가져올 저장소를 고르고 승인합니다.
돌아오면 {count}개 저장소의 커밋을 내 활동(내 매시)으로 받고 있어요.라고 표시됩니다. 저장소를 바꾸려면 저장소 추가·변경을 선택합니다.

내 저장소에서는 다음 규칙으로 커밋을 기록합니다.

내가 작성한 커밋만 기록합니다. 커밋 작성자가 내 GitHub 사용자명이나 확인된 이메일, 계정 이메일과 일치해야 하며, 다른 사람이나 봇이 작성한 커밋은 건너뜁니다.
기록 위치는 내 매시의 GitHub (내 저장소) 규칙 중 연결을 따릅니다. 기본값인 나에게만 기록 (기본) 상태이면 내 매시에만 기록되고, 워크스페이스를 고르면 그 워크스페이스 활동에도 표시됩니다.

조직(팀) 저장소를 팀 워크스페이스에 연결하는 일은 워크스페이스 설정 → 연동에서 합니다.

GitHub 활동의 공개 범위 기본값은 워크스페이스입니다. 내 매시의 GitHub (내 저장소) 규칙 중 공개를 바꾸면 이후 내 커밋으로 인식되는 GitHub 활동에 그 공개 범위가 적용됩니다.
연결 규칙은 워크스페이스에 연결되지 않은 저장소(기본 수신 중, 내 저장소)의 커밋에만 적용됩니다. 이 워크스페이스로 수신하는 저장소의 커밋은 항상 그 워크스페이스에 기록됩니다.
내 매시에서 GitHub 활동은 출처 워크스페이스만 표시되며, 개별로 옮기거나 일괄 선택할 수 없습니다.

규칙 패널의 사용법은 활동과 내 매시를 참고하세요.

커밋 요약에는 AI 사용량이 쓰입니다. 사용량은 저장소가 연결된 워크스페이스에서 차감되며, 내 저장소는 계정 메뉴 워크스페이스 목록의 첫 번째 워크스페이스를 기준으로 연결됩니다.

그 워크스페이스가 Free 플랜이고 이번 달 무료 AI 사용량을 모두 썼다면, 그동안 푸시된 커밋은 기록되지 않고 건너뜁니다. 사용량이 매월 1일에 초기화된 뒤에도 건너뛴 커밋을 다시 가져오지는 않습니다.
Plus와 Business 플랜은 더 많은 월간 AI 사용량을 제공합니다. 요금제와 한도
AI 요약이 실패한 커밋도 기록되지 않습니다. 요약 없이 커밋 로그만 남기지는 않습니다.