에이전트 캣 — Claude Code / Codex / Gemini CLI 상태를 메뉴바 고양이로 모니터링

에이전트 캣 — 메뉴바 고양이로 AI 에이전트 상태 모니터링

에이전트 캣 — Claude Code / Codex / Gemini CLI 상태를 메뉴바 고양이로 모니터링

저는 AI 에이전트를 두세 개씩 동시에 띄워놓고 일하는 편입니다. 그런데 띄워놓고 다른 일을 하다 보면 "얘 지금 뭐 하고 있지? 끝났나? 멈췄나?"가 자꾸 궁금해집니다. 그때마다 Activity Monitor 열고, 또 터미널 가서 로그 확인하는 게 귀찮아서 만든 도구가 있습니다. 에이전트 캣(Agent Cat)입니다.

메뉴바(macOS) / 트레이(Windows) 한 칸에 고양이가 삽니다. 에이전트가 쉬면 자고, 작업 중이면 걷고, 풀가동이면 뜁니다. 클릭하면 누가 무슨 모델로 얼마나 썼고, 어떤 프로젝트에 시간을 흘렸는지가 펼쳐집니다.

에이전트 캣이란

에이전트 캣은 AI 코딩 에이전트의 상태와 사용량을 실시간으로 모니터링하는 오픈소스 앱입니다. 현재 Claude Code, Codex, Gemini CLI, OpenCode, GitHub Copilot을 지원합니다.

핵심 구조

앱이 에이전트랑 직접 말하지 않습니다. 사이에 agentcatd라는 작은 로컬 데몬을 둡니다.

Claude Code · Codex · Gemini CLI · OpenCode · Copilot|(어차피 로컬에 남기는 흔적들)vagentcatd|JSON via 127.0.0.1:8765/v1/snapshotv메뉴바 앱

데몬이 각 에이전트가 로컬에 남기는 흔적, 즉 프로세스 상태와 사용량 파일을 정리해서 JSON으로 제공합니다. 메뉴바 앱은 그것만 폴링합니다.

분리 구조의 장점

이렇게 갈라놓으면 두 가지가 편해집니다. 첫째, 새 에이전트 지원이 "앱 빌드 다시"가 아니라 "데몬에 어댑터 한 개"가 됩니다. 이번 빌드에 OpenCode와 GitHub Copilot이 들어온 것도 그래서입니다.

둘째, 그 데몬만 따로 떼어 오픈소스로 공개할 수 있게 됐습니다. 진짜 프롬프트를 안 보고 토큰을 빨아먹는 게 아닌지 의심하는 목소리에, 코드를 누구나 줄 단위로 까서 볼 수 있습니다.

설치 방법

한 줄이면 됩니다.

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/yong076/agentcat-connectors/… | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/yong076/agentcat-connectors/… | iex

privacy 설계

에이전트 캣은 API 호출을 하지 않습니다. 토큰을 한 개도 안 씁니다. 프롬프트도, 코드도 안 봅니다. 프로세스 메타랑 사용량 파일만 읽습니다.

저도 사실 이렇게 안 만들었으면 "내 컴퓨터에 또 뭘 깔라고"가 됐을 거라 생각합니다. 메뉴바 한 칸 차지하면서 알림 쏘고 토큰 빨아먹는 앱이면 저부터 안 켜고 살았을 것입니다.

비용 계산 방식

입력 / 출력 / 캐시 읽기 / 캐시 쓰기를 따로 잡아 계산합니다. 단가가 각각 달라서 "토큰 N개 썼습니다"로 합치면 청구서랑 안 맞습니다. 청구서랑 거의 안 어긋나게 만드는 게 목표였습니다.

함께 보면 좋은 유사 도구

에이전트 캣 외에 비슷한 용도의 도구들이 있습니다.

• so-agentbar — Claude Code 세션과 상태를 메뉴바에서 모니터링하는 macOS 앱

• CodexBar — Codex, Claude Code 등의 사용량 통계를 편하게 보기

• tunaLlama — Claude Code / Codex CLI의 무거운 코드 생성을 로컬 LLM으로 위임하는 플러그인

• devglow — AI 코딩 시대를 위한 macOS 개발 서버 매니저

마무리

여러 개의 AI 에이전트를 동시에 사용하는 개발자라면, 에이전트 캣 하나로 모든 에이전트의 상태를 한눈에 볼 수 있습니다. 고양이가 졸리면 에이전트가 쉬는 중, 고양이가 걸어다니면 작업 중, 고양이가 뛰어다니면 풀가동입니다.

• 사이트: https://agentcat.app

• 이슈/피드백: https://github.com/yong076/agent-cat-releases/issues

실제로 사용하고 있는 개발자도 있으니, 관심 있다면일해 볼 만한 도구입니다.

---

📚 출처

• https://news.hada.io/topic?id=29649