피드로 돌아가기
Show GN: 에이전트 캣 — Claude Code / Codex / Gemini CLI 의 상태와 사용량을 메뉴바 고양이로
GeekNewsGeekNews
Infrastructure

Show GN: 에이전트 캣 — Claude Code / Codex / Gemini CLI 의 상태와 사용량을 메뉴바 고양이로

로컬 데몬 기반 Adapter 패턴을 통한 AI 에이전트 상태 모니터링 구조 설계

yong0762026년 5월 19일2intermediate

Context

복수 AI 에이전트 운용 시 프로세스 상태 및 리소스 사용량 확인을 위해 Activity Monitor와 터미널 로그를 반복 확인하는 운영 비효율 발생. 클라이언트 앱이 각 에이전트에 직접 접근할 경우 발생하는 높은 결합도와 보안 우려 해결이 필요함.

Technical Solution

  • agentcatd라는 로컬 데몬을 중간 계층으로 배치한 Decoupled Architecture 설계
  • 에이전트별 로컬 로그 및 프로세스 메타데이터를 수집하여 표준 JSON 포맷으로 제공하는 Snapshot API 구현
  • 신규 에이전트 추가 시 앱 수정 없이 데몬 내 Adapter만 추가하는 확장 구조 채택
  • 보안 및 신뢰성 확보를 위한 데이터 수집 데몬의 오픈소스 공개 전략 수행
  • API 호출 및 토큰 소모를 완전히 배제한 로컬 파일 기반 상태 추적 방식 적용
  • Input, Output, Cache Read/Write 단가를 개별 계산하는 정밀 비용 산출 로직 구현

- 외부 도구 통합 시 직접 연결 대신 로컬 데몬을 통한 추상화 계층 도입 검토 - 확장성 확보를 위해 Core 로직과 개별 서비스 연결부(Adapter)를 분리하여 설계 - 사용자 보안 우려 해소를 위해 데이터 수집부의 투명한 코드 공개 전략 활용

원문 읽기