jitters-cli는 커밋과 작업 시간을 원숭이로 보여준다

jitters-cli는 최근 커밋 시간과 횟수에 따라 원숭이 캐릭터의 상태를 보여주는 명령줄 도구다. Claude Code 상태 표시줄에 연결하면 세션 시간과 컨텍스트 사용량에 따라 캐릭터의 상태도 바뀐다.

설치는 uvx jitters-cli로 실행하거나 pipx run jitters-cli를 사용할 수 있다. Node.js 환경에서는 다음 명령으로 실행한다.

uvx jitters-cli 
(or `pipx run jitters-cli`; with Node: `npx -y https://vibeoverflow.lol/dl/jitters-cli.tgz`)

최근 7일 동안 실행한 폴더에서 본인의 커밋 날짜와 시간만 읽는다. 기본적으로 git config user.email에 설정된 작성자의 커밋을 대상으로 하며, --all 옵션을 쓰면 모든 작성자의 커밋을 센다. 제작팀은 네트워크 호출과 원격 측정이 없고, 기분을 나타내는 단어만 링크에 담긴다고 설명한다. 결과를 그림으로 확인하고 저장할 수 있는 페이지도 제공한다.

상태는 규칙에 따라 정해진다. 7일 동안 커밋이 없으면 sofa, 커밋의 3분의 1 이상이 자정부터 오전 5시 사이면 groggy, 하루 10회 이상이면 wired다. 낮 시간대 커밋이 5일 이상이고 자정 이후 커밋이 없으면 fit이 되며, 하루 한 번 이상은 steady, 하루 평균 한 번 미만은 sleepy로 표시한다.

Claude Code에 연결하려면 먼저 설치한 뒤 ~/.claude/settings.json에 상태 표시줄 명령을 설정한다. 기존 상태 표시줄이 있다면 뒤에 이어 실행할 수도 있다.

uv tool install jitters-cli      # or: pipx install jitters-cli 

{ "statusLine": { "type": "command", "command": "jitters-cli statusline" } }

{ "statusLine": { "type": "command", "command": "jitters-cli statusline -- ~/.claude/statusline.sh" } }

이 모드에서는 Claude Code가 전달하는 세션 시간과 컨텍스트 사용량, 현재 시각만 읽고, 제작팀 설명에 따르면 정보는 기기 밖으로 나가지 않는다. 실행 시간은 회당 약 25밀리초다. iTerm2, Kitty, WezTerm에서는 jitters라는 단어를 클릭해 해당 상태의 그림을 볼 수 있고, --no-link로 링크를 끌 수 있다.

코딩 에이전트 연동용 MCP 서버에는 jitters_week 도구 하나가 포함된다. 표준 입력·출력으로 서버를 실행하려면 다음 설정을 사용한다.

{ "mcpServers": { "jitters": { "command": "uvx", "args": ["jitters-cli", "--mcp"] } } }

Claude Code에서는 claude mcp add jitters -- uvx jitters-cli --mcp 명령으로 추가할 수 있다. 그 밖에 --json은 결과를 JSON으로 출력하고, --all은 모든 작성자의 커밋을 집계하며, statusline은 상태 표시줄 모드를 실행한다.