agenteye CLI는 대시보드와 통신합니다. 서버로 이벤트를 전송하는 수집기(collector)와는 별개의 도구입니다.
배포 환경 전체를, 명령어 하나로
사소한 질문 하나 때문에 탭을 이리저리 옮겨 다닐 필요가 없습니다.agenteye CLI는 단일 바이너리로 데이터를 읽고 조직을 관리하므로, 대시보드를 클릭하며 확인하던 작업이 한 줄 명령어로 끝납니다. 재실행하거나 alias로 등록하거나 런북에 붙여넣기도 가능합니다. 네 가지 기능을 제공합니다:
- 데이터 조회:
sessions,events,evals,errors를 시간, 에이전트, 환경별로 필터링. - 조직 관리:
keys,users,settings,alerts,incidents. - 분석 실행: 저장된 SQL 쿼리 및 이벤트 데이터에 대한 임시
query실행. - 어시스턴트 호출:
agent ask로 대시보드에서 대화하는 것과 동일한 읽기 전용 분석가에게 질의.
pipx로 한 번 설치하고, 이메일로 전송된 6자리 코드로 로그인하면 준비 완료입니다. 세션은 약 하루 동안 유지되며, 만료되면 agenteye login을 다시 실행하세요. 브라우저를 열지 않고도 프로덕션 점검, 키 발급, 발생 중인 인시던트 분류를 모두 처리할 수 있습니다:
--json과 같은 전역 옵션은 명령어 앞에 위치해야 합니다. agenteye --json sessions는 올바른 형식이고, agenteye sessions --json은 올바르지 않습니다.
스크립트 작성 및 CI 연동
모든 명령어는--json을 지원하며, 이것이 큰 차이를 만듭니다. 깔끔한 JSON은 stdout으로 출력되고 사람이 읽는 상태 메시지와 경고는 stderr로 분리되므로, --json 출력을 파이프로 jq에 바로 연결해도 불필요한 줄을 제거할 필요가 없습니다. 덕분에 터미널에서 직접 사용할 때나 코딩 에이전트가 출력을 파싱할 때 모두 동일하게 잘 작동합니다:
0 성공, 4 미로그인, 5 권한 부족(메시지에 필요한 권한 명시, 예: alerts:write), 3 대시보드 연결 불가. 스크립트에서 4를 받으면 재인증 로직을 실행하거나, 5를 받으면 관리자에게 정확히 어떤 권한을 요청해야 하는지 알 수 있습니다. 원인을 모른 채 실패하는 일이 없습니다.
코딩 에이전트에게 자연어로 맡기기
사실 이 플래그들을 외울 필요조차 없습니다. CLI 스킬은agenteye-cli라는 작은 Agent Skill 폴더로, Claude Code나 Codex 같은 코딩 에이전트가 자연어 요청으로 CLI를 구동할 수 있도록 가르칩니다. “오늘 뭔가 문제가 있나요?”라고 물으면 에이전트가 적절한 명령어를 선택해 실행하고 결과를 문장으로 답변합니다.
Claude Code의 경우, agenteye-cli 폴더를 ~/.claude/skills/에 넣으면 자동으로 인식됩니다. FailproofAI Observability가 해당 폴더를 제공하며, 이미 설치된 CLI를 구동하는 것뿐이므로 추가로 설치할 것은 없습니다. 로그인은 직접 먼저 해두어야 합니다. 이메일 코드 로그인 과정은 스킬이 대신 완료할 수 없습니다.
에이전트는 사용자의 로그인으로 CLI를 실행하므로, 키 생성, 설정 변경, 인시던트 해결 등 로그인 권한 내의 모든 읽기/쓰기 작업을 수행할 수 있습니다. CLI의 확인 프롬프트는 에이전트 실행 시 동작하지 않으므로, 스킬은 변경 작업 전에 정확한 명령어를 명시하고 사용자의 승인을 기다리도록 작성되어 있습니다. 확인 단계는 사용자가 직접 담당합니다.
관련 문서
- CLI 레퍼런스: 모든 명령어, 플래그, JSON 형식.
- 에이전트용 CLI 레시피: 복사하여 사용할 수 있는
jq패턴과 종료 코드 처리 방법. - CLI 에이전트 스킬:
agenteye-cli스킬 설치 및 실행. - AI 어시스턴트:
agent ask가 연결되는 대시보드 내 분석가.