farjadahmed/agentwatch클로드 코드용 무음 세션 기록기로, 모든 작업을 기록하고 위험한 명령어(rm -rf, sudo, curl|sh)를 플래그 지정하며, 타임라인 검토, 위험 경고 및 프로젝트 간 분석을 제공합니다.
Claude Code 세션용 비행 기록기입니다.
Claude Code를 머신에서 실행하게 놔두세요 — 때로는 몇 시간, 때로는 자동 승인으로. agentwatch는 모든 작업을 조용히 기록하여, 나중에 돌아와 정확히 무슨 일이 일어났는지 확인할 수 있습니다.
npm install -g agentwatch-dev
agentwatch install
그게 다입니다. 두 개의 명령어입니다. agentwatch는 이제 모든 Claude Code 세션을 기록하고 있습니다.
agentwatch last # 방금 무슨 일이 있었나?
agentwatch danger # 위험한 일이 있었나?
agentwatch report # 모든 프로젝트에 대한 주간 요약
last는 가장 자주 실행하게 될 명령어입니다. 세션 후 — 특히 자리를 비운 긴 세션 — 전체 타임라인을 제공합니다: 모든 명령어, 모든 파일 접근, 모든 플래그된 위험.
danger는 rm -rf, sudo, curl | sh, .env 또는 에 쓰기, 강제 푸시 등 — 알고 싶은 모든 것을 스캔합니다.
.sshreport는 시간 경과에 따른 패턴을 보여줍니다: 가장 많이 AI를 사용하는 프로젝트, 계속 수정되는 파일, 계속 실패하는 명령어.
SESSION REVIEW
agentwatch last 가장 최근 세션 검토
agentwatch show <id> ID 접두사로 특정 세션 표시
agentwatch sessions 모든 기록된 세션 나열 (--all 전체 목록)
agentwatch live 현재 세션을 터미널에서 실시간 추적
agentwatch commands 모든 bash 명령어와 성공/실패 상태
agentwatch files 모든 접근된 파일 (읽기/편집/쓰기)
agentwatch danger 잠재적 위험 행위 플래그
agentwatch export [id] 마크다운으로 내보내기 (--json JSON)
agentwatch tokens [id] 세션의 토큰 사용량 분석
ANALYTICS
agentwatch report [period] 주간 보고서 — 프로젝트, 핫스팟, 패턴
period: week (기본값), month, 또는 일 수
agentwatch hotspots [n] AI가 세션 간 가장 많이 수정하는 상위 N개 파일
agentwatch stats 프로젝트별 분석이 포함된 통계
MANAGEMENT
agentwatch dash 웹 대시보드를 브라우저에서 열기
agentwatch status agentwatch 설치 및 작동 상태 확인
agentwatch prune [days] N일 이상 된 세션 삭제 (기본값: 30)
agentwatch install Claude Code에 후크 추가
agentwatch uninstall 후크 제거 (로그는 보존됨)
agentwatch hotspots는 모든 세션에서 AI가 가장 많이 접근하는 파일을 보여줍니다. 반복적으로 수정되는 파일은 종종 복잡하거나, 취약하거나, 활발히 개발 중인 코드를 나타냅니다.
| 패턴 | 수준 |
|---|---|
rm -rf | 심각 |
curl | sh | 심각 |
sudo | 심각 |
git push --force | 심각 |
git reset --hard | 심각 |
.env, .ssh, .aws에 쓰기 | 심각 |
/etc/, /usr/에 쓰기 | 심각 |
find -exec rm / find -delete | 심각 |
mkfs, dd if= | 심각 |
curl/wget to external hosts | 경고 |
git push --force-with-lease | 경고 |
.env, .ssh/id_rsa 읽기 | 경고 |
eval | 경고 |
ssh/scp | 경고 |
kill -9, pkill, killall | 경고 |
pip install/npm install | 정보 |
docker run | 정보 |
심각 및 경고 위험은 실시간으로 macOS 알림을 트리거합니다. 정보 수준 이벤트는 조용히 기록됩니다.
agentwatch는 Claude Code의 후크 시스템을 사용합니다:
~/.agentwatch/sessions/에 JSONL 형식으로 저장됩니다.후크는 3초 타임아웃과 자동 실패로 비동기적으로 실행됩니다 — Claude Code를 차단하거나 방해하지 않습니다. 모든 데이터는 머신에 로컬로 유지됩니다.
agentwatch uninstall # Claude Code 설정에서 후크 제거
npm uninstall -g agentwatch-dev
세션 로그는 ~/.agentwatch/에 보존됩니다 — 원한다면 수동으로 삭제하세요.
MIT — Farjad Ahmed 제작