agenttrim은(는) 무엇을 하나요?
텔레메트리 기반 AI 에이전트 설정 정리 및 최적화 엔진입니다. 스킬/MCP 사용량을 모니터링하고 사용하지 않는 리소스 제거를 권장합니다.
개요
agenttrim은 AI 에이전트(예: Claude Code, Cursor, Codex)의 설정 파일에서 불필요하거나 사용되지 않는 구성을 찾아 정리하는 도구입니다. 시간이 지남에 따라 에이전트 설정이 다양한 스킬, MCP 서버, 도구, 프롬프트 등으로 복잡해지고 비대해지는 문제를 해결합니다. 이 도구는 실제 텔레메트리 데이터를 분석하여 어떤 리소스가 자주 사용되고 어떤 리소스가 거의 또는 전혀 사용되지 않는지 파악한 후, 사용자에게 안전하게 제거할 수 있는 리소스 목록을 제시합니다.
주요 기능
- 사용량 모니터링: 에이전트가 실행되는 동안 각 스킬, MCP 도구, 명령어의 사용 빈도를 추적합니다.
- 정리 권장: 일정 기간 동안 사용되지 않은 리소스를 식별하고 제거를 권장합니다.
- 진공 청소 모드: 사용자의 확인 없이 안전하게 제거할 수 있는 리소스를 자동으로 정리합니다.
- 통계 대시보드: 각 리소스의 사용 통계를 보여주는 간단한 보고서를 생성합니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex CLI
- 일반적인 AI 에이전트 설정 파일
설치
npm install -g agenttrim
# 또는
npx agenttrim init
사용법
기본 명령어
# 현재 설정 분석
agenttrim analyze
# 사용되지 않는 리소스 목록 보기
agenttrim list-unused
# 권장 정리 적용 (사용자 확인 필요)
agenttrim prune
# 자동 정리 (확인 없이 안전한 리소스만)
agenttrim vacuum
설정 예제
agenttrim.config.json 파일을 프로젝트 루트에 생성합니다:
{
"watchInterval": 3600,
"unusedThresholdDays": 30,
"autoVacuum": false,
"excludedPatterns": ["core-*"]
}
작동 방식
- 에이전트 실행 시
agenttrim이 백그라운드에서 각 리소스 호출을 기록합니다. - 기록된 데이터는 로컬 SQLite 데이터베이스에 저장됩니다.
prune또는vacuum명령 실행 시 저장된 데이터를 분석하여 사용 패턴을 파악합니다.- 설정된 임계값(예: 30일)보다 오래 사용되지 않은 리소스를 후보로 선정합니다.
- 사용자에게 제거할 리소스 목록을 제시하거나(prune) 자동으로 제거합니다(vacuum).
환경 변수
AGENTTRIM_CONFIG_PATH: 설정 파일 경로 지정AGENTTRIM_VERBOSE: 상세 로그 출력 (true/false)
참고
이 도구는 실험적인 프로젝트입니다. 프로덕션 환경에서 사용하기 전에 충분히 테스트하세요. 항상 정리 전에 설정 파일의 백업을 권장합니다.