메인 화면
지금 누가 일하고 있나요?
켜져 있는 에이전트와 활동 상태를 한 번에 확인해요. 아무도 일하지 않으면, 고양이도 같이 새근새근 잠듭니다.
macOS & Windows Companion
에이전트 체크해주는 고양이,
입양 하세요.
Codex, Claude Code, Gemini CLI가 뭐 하고 있는지,
트레이에 사는 고양이가 다 챙겨봐 줘요.
무료 · macOS 14+ (Apple Silicon & Intel) · Windows 10/11 (x64) · 명이 입양했어요
메뉴바에 살아있는 신호
터미널을 따로 열어보지 않아도, 지금 어떤 에이전트가 일하고 있는지 메뉴바에서 바로 보여요.
토큰도, 프롬프트도 쓰지 않아요
토큰을 소비하지 않고, 프롬프트 인젝션도 사용하지 않습니다. 로컬 스냅샷을 그대로 보여드릴 뿐이에요. 자세히 →
지원하는 에이전트
OpenAI Codex, Anthropic Claude Code, Google Gemini CLI까지. 모두 이 Mac 안에서 도는 것만 봅니다.
화면
단순하게, 필요한 것만
팝오버 하나에 에이전트 목록, 활동 지표, 설정까지 다 들어 있어요.
다중 에이전트
Codex · Claude · Gemini, 한 화면에
세 에이전트의 실행 상태, 사용량, 일별 추이까지 대시보드 한 곳에 모았어요. 따로따로 창을 띄워 비교할 필요가 없어요.
다국어
한국어 · English · 日本語 · 简体中文
시스템 기본값을 포함해 4개 국어를 지원해요. 어떤 언어로 켜도 같은 정보를 같은 자리에서 봅니다.
Windows
Windows에서도 똑같이, 한 마리
macOS 메뉴바 그대로, Windows 10 · 11 트레이 위에서도 똑같이 동작해요. Codex · Claude · Gemini, 같은 시스템 같은 화면.
- Windows 10 / 11 (x64) 지원
- 트레이 아이콘 + 팝오버 동일 경험
- 26마리 마스코트 그대로
Windows용 .exe 받기
첫 실행 시 SmartScreen 안내가 떠도 추가 정보 → 실행 으로 진행하면 돼요.
움직임
고양이의 속도가, 에이전트의 속도
활동량에 따라 메뉴바 고양이의 움직임이 세 단계로 바뀌어요. 아이콘 한 번만 흘끗 봐도 지금 상황이 그려집니다.
대기 쿨쿨
실행 중인 에이전트가 없거나, 다들 조용할 때예요. 고양이도 그 옆에서 같이 한숨 자고 있어요.
걷기 걷는 중
에이전트가 깨어 있지만 살살 움직이는 중이에요. 응답을 기다리거나, 다음 명령을 받고 있을 가능성이 높습니다.
뛰기 뛰는 중
활동량이 한껏 올라간 상태예요. 코드를 쓰거나, 무거운 작업이 한창 돌아가고 있을 거예요.
이렇게 측정해요
CPU 사용률에 돌아가는 프로세스 수를 더해 활동 점수를 계산합니다. 점수가 올라갈수록 고양이 걸음도 같이 빨라져요.
데이터는 여기서
화면 계산은 이 Mac 안의 agentcatd snapshot만 사용해요. 프롬프트, 응답, 코드는 들여다보지 않습니다.
마스코트
고양이부터 판타지 친구들까지, 다 같이 움직여요
취향대로 메뉴바 마스코트를 골라 쓸 수 있어요. 어떤 친구를 골라도, 활동량에 맞춰 똑같이 빨라집니다.
고양이 기본
잠들고, 걷고, 뛰는 기본 친구예요. 앱 안에서 여러 색상의 고양이 중 마음에 드는 아이를 고를 수 있습니다.
치타 신규
활동량이 올라갈수록 더 잘 어울리는 빠른 러너예요. 메뉴바에서도 그 속도감 그대로입니다.
말 신규
새로 합류한 말 친구예요. 무거운 작업이 돌 때 메뉴바에서 경쾌하게 달려갑니다.
머니건 신규
활동량이 올라갈수록 지폐를 더 많이 쏩니다. 보고만 있어도 기분이 좋아져요.
골든 리트리버 신규
멈추고, 걷고, 뛰고, 전력질주까지 4단계로 움직이는 강아지 친구예요.
치와와 신규
작은 몸으로 누구보다 빠르게 움직이는 강아지예요.
웰시코기 신규
짧은 다리지만 누구보다 부지런하게 움직이는 강아지예요.
포메라니안 신규
복슬복슬한 실루엣이 메뉴바에서도 눈에 쏙 들어옵니다.
시바견 신규
가볍게 걷고 뛰는, 똘똘한 강아지 친구예요.
아기 여우 신규
작은 여우가 작업량에 맞춰 슥슥 달려갑니다.
수달 신규
낮게 미끄러지듯 움직이는 게 매력 포인트인 친구예요.
아기 펭귄 신규
작은 펭귄이 멈춤, 걷기, 뛰기, 전력질주까지 모두 보여줘요.
햄스터 신규
동글동글한 햄스터가 활동량을 귀엽게 알려줍니다.
고슴도치 신규
작업이 커지면 데굴데굴 빠르게 굴러갑니다.
레서판다 신규
부드럽게 움직이는 모습이 사랑스러운 레서판다예요.
아기 토끼 신규
통통 튀는 발걸음으로 지금 작업 상태를 알려줍니다.
아기 공룡 신규
초록 공룡이 에이전트와 호흡 맞춰 움직여요.
아기 드래곤 신규
작은 판타지 친구예요. 무거운 작업이 돌 때 한층 또렷이 보입니다.
슬라임 신규
말랑말랑한 움직임으로 지금 활동 상태를 알려줍니다.
버섯 요정 신규
작은 숲속 친구 같은 분위기의 마스코트예요.
구름 생물 신규
둥실둥실 떠다니며 작업이 얼마나 활발한지 보여줍니다.
작은 유령 신규
조용한 작업에도 잘 어울리는, 깃털처럼 가벼운 유령 친구예요.
미니 골렘 신규
단단한 분위기의 든든한 친구예요.
아기 그리핀 신규
날개 달린 친구가 작업량에 맞춰 부지런히 움직여요.
아기 문어 신규
통통 튀는 움직임이, 보고만 있어도 귀여워요.
아기 악어 신규
낮게 달리는 모습으로 활동량 변화를 살뜰히 보여줍니다.
설정 → 마스코트에서 언제든 마음에 드는 친구로 갈아끼울 수 있어요.
지원 에이전트
이미 쓰고 있는 그 도구들
새로 뭘 설치할 필요 없어요. 평소 터미널에서 돌리는 AI CLI를 그대로 알아봅니다.
OpenAI Codex
Codex CLI의 실행 상태와 활동량을 살펴봐요. 세션이 실제로 움직이기 시작하면 마스코트도 곧장 반응합니다.
Anthropic Claude Code
Claude Code의 프로세스 활동을 따라갑니다. 로컬에 컨텍스트 사용량이 노출되어 있다면 그것도 함께 보여드려요.
Google Gemini CLI
Gemini CLI의 활동을 읽어옵니다. 사용 한도는 로컬에 노출된 값만 그대로 표시해요.
Available now
macOS
Apple Silicon & Intel · macOS 14 이상
Available now
Windows
Windows 10 / 11 · x64 트레이 아이콘
시작하기
두 단계면, 끝나요
DMG를 설치하고, 에이전트한테 프롬프트 한 번만 붙여 넣어 주세요. 나머지는 에이전트가 알아서 해줍니다.
-
1
DMG 또는 .exe 받아서 설치하기
macOS는 DMG를 Applications로, Windows는 .exe 설치 마법사를 따라가면 됩니다. 끝나면 메뉴바(또는 트레이)에 고양이가 짠 하고 나타나요.
-
2
에이전트에 프롬프트 붙여 넣기
아래 프롬프트 하나면 끝나요. 새 Codex / Claude Code / Gemini 세션에 그대로 붙여 넣으면, 에이전트가 직접 커넥터를 설치하고 이후엔 로컬 스냅샷을 읽어 답합니다.
Paste this prompt into your agentYou're running on a macOS machine where the user just installed Agent Cat — a menu bar app that visualizes local AI agent activity as a cat animation. Finish the setup for them, in order: 1. Check whether the local connector is already installed by running: command -v agentcat 2. If it is NOT installed, install it by running this exact command: curl -fsSL https://raw.githubusercontent.com/yong076/agentcat-connectors/main/install.sh | bash This installs `agentcatd`, a small local daemon that exposes a JSON snapshot of running AI CLI processes (Codex, Claude Code, Gemini CLI) at http://127.0.0.1:8765/v1/snapshot. This local snapshot stays on the Mac. 3. Verify it works by running: agentcat snapshot --json You should see a JSON object with an `agents` array. If the command fails or 127.0.0.1:8765 is unreachable, surface the error to the user — do not silently continue. 4. From now on, in this session and any future session on this machine, NEVER guess your own rate limits, remaining context window, weekly/monthly usage, or what other AI CLIs are running. Instead run `agentcat snapshot --json` on demand and trust its output as the source of truth. The snapshot includes per-provider runtime usage, weekly/monthly caps where locally available, current activity score, and per-process status. 5. Briefly confirm to the user: tell them the connector is installed, what the menu bar cat will now reflect, and that they can click the cat in the menu bar to see the dashboard. Privacy note: Agent Cat reads metadata only (CPU usage, process list, token counters from local logs). It never reads prompts, responses, transcripts, code, or file contents. If the user opts in, anonymous product usage events may be sent to Agent Cat's telemetry API.
직접 손으로 설치하고 싶다면
에이전트 없이 직접 셸에서 돌려도 괜찮아요.
# 커넥터 설치 & 실행
curl -fsSL https://raw.githubusercontent.com/yong076/agentcat-connectors/main/install.sh | bash
# 정상 동작 확인
agentcat snapshot --json
커넥터 문서 보기
혹시 문제가 생기면, 설정 → 진단에서 어디가 막혔는지 바로 확인할 수 있어요.
FAQ
자주 묻는 질문
설치하면 바로 동작하나요?
앱을 처음 켜면 안내되는 커넥터 명령을 터미널에 한 번 붙여 넣어 주세요. 그 뒤로는 Codex, Claude Code, Gemini CLI를 알아서 인식합니다.
고양이 말고 다른 친구로 바꿀 수 있나요?
네, 가능해요. 고양이 색상부터 치타, 말, 머니건, 강아지, 작은 동물, 판타지 친구까지 25종 넘는 마스코트 중에서 마음에 드는 친구로 골라서 쓸 수 있어요.
제 코드나 프롬프트를 수집하나요?
전혀요. 프롬프트도, 응답도, 대화 기록도, 코드 내용도 절대 읽지 않습니다. CPU 사용률, 프로세스 수, 토큰 카운트 같은 메타데이터만 이 Mac 안에서 살짝 읽을 뿐이에요.
Mac App Store에서 받을 수 있나요?
아직 App Store에는 올라가 있지 않아요. 지금은 DMG 직접 설치로만 받을 수 있고, 정식 배포는 준비되는 대로 따로 알려드릴게요.
배터리나 CPU에 영향을 주나요?
거의 없어요. 무거운 연산은 하지 않습니다. 익명 통계 전송도 옵트인 상태에서만 가볍게 동작해요.
여기 없는 질문이 있다면
기능 제안이나 버그, 사용하면서 떠오른 작은 아이디어까지 — 모두 GitHub 이슈 한 곳에 모으고 있어요. 의견 남기러 가기 ↗
팁
플랫폼별 잘 쓰는 법
메뉴바와 트레이는 OS마다 살짝씩 달라요. 더 잘 보이게 두는 작은 팁들이에요.
macOS
사용 가능-
노치 뒤로 숨었어요
메뉴바 아이콘이 많으면 MacBook 노치 뒤로 가려질 수 있어요. ⌘ 누른 채로 고양이를 드래그하면 자리를 옮길 수 있습니다. 시스템 아이콘(Wi-Fi · 배터리 · 시계) 쪽인 오른쪽 가까이로 보내두면 노치를 안 만나요.
-
로그인 시 자동 실행
시스템 설정 → 일반 → 로그인 항목에 Agent Cat을 추가하면, Mac을 켤 때마다 메뉴바에서 알아서 깨어납니다.
-
Bartender · Ice · Hidden Bar 호환
메뉴바 매니저 앱들과도 정상적으로 같이 동작해요. 자주 보고 싶다면 항상 노출 슬롯에 두는 걸 추천합니다.
Windows
사용 가능-
트레이에서 아이콘 고정
Windows 트레이는 아이콘이 많으면 ▲(숨겨진 아이콘)으로 들어가요. 작업 표시줄 설정 → 트레이 아이콘에서 Agent Cat을 "항상 표시"로 고정해두면 가장 잘 보입니다.
-
시작 시 자동 실행
설정 → 앱 → 시작에서 Agent Cat을 켜두면, Windows를 켤 때마다 트레이에서 알아서 깨어납니다.
-
SmartScreen 안내
처음 실행할 때 "Windows에서 PC를 보호했습니다" 창이 뜰 수 있어요. 추가 정보 → 실행 으로 진행하면 됩니다. 코드 서명은 곧 붙일 예정이에요.
함께 만들어요
개선 사항 및 건의도 여러분에게 열려 있습니다
지금까지 모인 아이디어와 다음에 만들 것들을 GitHub Issues 에 공개해 두고 있어요. 사용하면서 떠오른 작은 의견도 같이 남겨주세요.