깃허브 프로필에 내 활동으로 자라는 잉어, git-koi 붙이는 법

yalongwastaken/git-koi는 깃허브 계정의 공개 활동으로 픽셀 아트 잉어를 그리는 도구입니다. 2026년 10월 26일 공개됐고 라이선스는 MIT입니다. 매일 밤 GitHub Actions가 새로 그려 프로필 README에 움직이는 GIF로 붙입니다.

잉어가 정해지는 법

색: 내가 쓰는 프로그래밍 언어
크기: 기여가 많을수록 자람
무늬: 연속 기여 기록
헤엄치는 모습: 막 끝난 하루의 활동

몸 바탕색은 white, black, asagi, tea, gold, platinum 여섯 가지 중에 고릅니다.

프로필에 붙이기

깃허브는 내 아이디와 같은 이름의 저장소(예: octocat/octocat) README를 프로필에 보여 줍니다.

examples/profile-workflow.yml을 그 저장소의 .github/workflows/koi.yml로 복사합니다.

README에 그림을 넣습니다.

<img src="koi/koi.gif" width="256" alt="My koi" />

저장소의 Actions 탭에서 워크플로를 한 번 실행합니다. 자정을 기다리지 않고 첫 잉어가 나옵니다.

워크플로는 UTC 자정 직후(한국 시각 오전 9시쯤) 돌아 막 끝난 하루를 그립니다. 워크플로의 기본 토큰으로 공개 활동만 읽고, 그림이 바뀌었을 때만 커밋합니다.

몸 색을 바꾸려면 워크플로의 body 값을 고치고 푸시하면 됩니다.

멈췄을 때

깃허브는 공개 저장소에서 60일 동안 푸시 같은 활동이 없으면 예약 워크플로를 멈춥니다. 잉어가 바뀌지 않는 조용한 기간이 길면 커밋도 없어서 멈출 수 있고, 저절로 다시 켜지지 않습니다. Actions 탭에서 다시 켜거나 gh workflow enable koi.yml을 실행하세요.

명령줄과 라이브러리

cargo install git-koi --locked

Releases의 실행 파일을 받아도 됩니다. 명령줄 도구는 인증된 GitHub CLI가 필요하고, Rust 라이브러리는 crates.io에 있습니다.

오늘 할 일

프로필 저장소에 액션 파일 하나를 넣고 첫 잉어를 띄워 보세요. 한 달쯤 지나면 내 활동이 잉어 크기로 보입니다.

쇼츠로 보기

이 글은 비치콤버스 쇼츠 No.74의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/74.