Clanking은 대형 언어 모델(LLM) 코딩 에이전트의 활동을 소리로 알려주는 도구다. 에이전트가 작업 중인지, 입력을 기다리는지, 응답을 마쳤는지 등을 신호음으로 구분하며 여러 에이전트의 소리를 함께 재생한다.
소리 구성과 작동 방식
코딩 에이전트의 훅이 Clanking 명령줄 인터페이스(CLI)를 호출하면, CLI는 각 이벤트를 읽고 해당하는 소리를 재생한다. 도구 호출에는 에이전트가 활성 상태임을 나타내는 짧은 음을 여러 음높이 중 하나로 재생한다. 응답 출력, 입력이나 권한 대기, 작업 완료, 오류를 알리는 소리도 제공한다.
Clanking은 첫 실행 때 데몬으로 시작하며, 이후 CLI 호출은 백그라운드 작업에 메시지를 보낸다. 소리는 설정된 템포에 맞춰 16분음표 간격으로 재생되며 기본 템포는 120BPM이다. 활동이 많을 때는 32분음표로 전환한다. 소리는 프로그램이 합성한다.
각 세션의 작업 디렉터리를 기준으로 스테레오 위치를 정해, 서로 다른 세션의 소리가 다른 방향에서 들리도록 한다. 템포와 기본 음은 명령줄이나 GTK 4 인터페이스에서 설정할 수 있다.
설치와 에이전트 설정
Clanking은 PipeWire와 pw-cat 유틸리티가 있는 유닉스 계열 시스템이 필요하다. 설정용 GTK 4 인터페이스는 선택 사항이다. Go로 제작됐으며, 빌드하려면 Go 도구 모음과 GTK 4 개발 라이브러리가 필요하다.
필요한 의존성과 GNOME이나 KDE 같은 XDG 방식의 데스크톱 환경을 갖춘 시스템에서는 make install로 clanking, clanking-ui, 데스크톱 파일, 아이콘을 홈 디렉터리에 설치할 수 있다. 포함된 Containerfile을 사용하면 시스템에 모든 개발 의존성을 설치하지 않고도 빌드할 수 있다. podman-make 스크립트가 컨테이너를 빌드하고 실행한다. Docker에 맞게 바꾸는 방법은 안내하지 않는다.
PipeWire가 설치된 시스템에서 clanking과 pw-cat을 $PATH에 두면 코딩 에이전트가 Clanking을 호출하도록 설정할 수 있다. Claude에서는 저장소의 마켓플레이스에서 플러그인을 설치한다.
/plugin install clanking --marketplace chrchr/clanking
Codex에서는 저장소를 플러그인 마켓플레이스로 추가한 뒤 플러그인을 설치한다.
codex plugin marketplace add chrchr/clanking
codex plugin add clanking@clanking
Codex를 다시 시작하고 /hooks를 실행한 다음 Clanking 훅을 신뢰하도록 설정해야 한다.
영감
제작자는 Michael Gilfix와 Tufts University의 Alva Couch 교수가 만든 Peep (The Network Auralizer): Monitoring Your Network With Sound, 스타트렉: 넥스트 제너레이션, 그리고 사건이나 정보를 짧은 소리로 나타내는 방식인 이어콘을 영감으로 꼽았다.
저작권은 Robert Church에게 있으며 표기는 © 2026이다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요