메인 콘텐츠로 건너뛰기
AgentEye CLI 스킬 (agenteye-cli)은 설치 가능한 Agent Skill로, Claude Code, Codex 등 호환 가능한 코딩 에이전트 도구가 자연어 요청을 통해 AgentEye 배포 환경을 agenteye CLI로 운용할 수 있도록 가르쳐 줍니다. 예를 들어 “오늘 문제 있는 게 있어?”, “CI에 이벤트 푸시만 가능한 키 줘”, “발생 중인 인시던트 확인하고 나한테 할당해줘” 같은 요청이 가능합니다. 이 스킬은 별도 서비스나 바이너리가 아닙니다. 이미 설치된 CLI 위에서 동작하는 소형 명령어 번들입니다. 에이전트가 agenteye --json … 명령을 실행하고 깔끔한 JSON을 파싱한 뒤 자연어로 결과를 알려줍니다. 스킬이 할 수 있는 모든 것은 동일한 명령어를 직접 입력해도 수행할 수 있습니다.

​
다른 AgentEye 인터페이스와의 관계

AgentEye는 동일한 데이터와 컨트롤에 접근하는 네 가지 방법을 제공하며, 서로 보완적으로 사용할 수 있습니다:
인터페이스설명실행 환경사용 시점
CLIagenteye 명령어/플래그 레퍼런스터미널특정 명령을 직접 실행하거나 스크립트로 작성할 때
CLI 레시피복사하여 바로 사용 가능한 jq/파이프라인 패턴터미널 / 스크립트CLI를 자동화에 연결할 때
CLI 스킬 (이 문서)CLI에 자연어 인터페이스를 제공하는 프론트엔드워크스테이션의 코딩 에이전트직접 물어보고 에이전트가 명령어를 선택하게 하고 싶을 때
대시보드 내 AI 어시스턴트대시보드에 내장된 채팅클러스터 내부의 agent 컨테이너대시보드에서 데이터를 Q&A 방식으로 조회하고 싶을 때

​
대시보드 내 AI 어시스턴트와의 차이 — 중요한 구분

두 도구는 영향 범위가 크게 다릅니다:
  • 대시보드 내 AI 어시스턴트 (assistant.md)는 내부 agent 컨테이너를 기반으로 대시보드에 내장된 채팅입니다. 읽기 전용 + 승인 기반 작성만 가능합니다. 저장된 쿼리와 대시보드를 초안으로 작성할 수 있지만, 모든 쓰기 작업은 사용자의 명시적인 클릭 승인을 요구하며 삭제는 불가능합니다. agent:use 권한으로 제한되며 현재 조회 중인 조직의 데이터만 볼 수 있습니다.
  • CLI 스킬은 사용자의 워크스테이션에서 사용자의 코딩 에이전트 내에 실행되며, 사용자 권한으로 agenteye CLI를 구동합니다. API 키 생성/교체/비활성화, 조직 설정 변경, 인시던트 해결, 저장된 쿼리 삭제 등 변경(mutation)을 포함한 CLI의 전체 기능을 수행할 수 있으며, CLI 로그인 권한 범위 내에서만 작동합니다. 해당 명령어를 직접 입력하는 것과 동일하게 신중하게 다루어야 합니다.

​
사전 요구 사항

  1. agenteye CLI가 설치되어 있고 PATH에 등록되어 있어야 합니다 (cli.md 참고 — pipx install agenteye).
  2. 대시보드 URL이 설정되어 있어야 합니다 (AGENTEYE_DASHBOARD_URL 환경 변수 또는 에이전트가 --base-url 옵션으로 전달).
  3. 로그인된 세션: 먼저 직접 agenteye login을 실행해야 합니다. 스킬은 이메일로 전송된 일회용 코드 로그인을 완료할 수 없습니다. 세션이 없거나 만료된 경우 (CLI 종료 코드 4) agenteye login을 실행하라고 안내합니다.

​
스킬 설치

Agent Skill은 SKILL.md(및 선택적 참조 파일)를 포함하는 폴더입니다. agenteye-cli 스킬을 설치하려면 에이전트가 스킬을 찾는 위치에 해당 폴더를 배치하면 됩니다:
  • Claude Code — agenteye-cli/ 폴더를 ~/.claude/skills/ (모든 프로젝트에서 사용 가능)에 복사하거나 <your-repo>/.claude/skills/ (해당 저장소로 범위 제한)에 복사합니다. Claude Code가 자동으로 감지합니다. /skills 목록으로 확인하거나 스킬 설명과 관련된 질문을 해보세요.
  • Codex (OpenAI) — Codex는 동일한 SKILL.md를 읽습니다. 번들에 포함된 agents/openai.yaml에 allow_implicit_invocation: true가 설정되어 있어, 태스크가 일치하면 Codex가 자동으로 스킬을 선택합니다. 그렇지 않은 경우 $agenteye-cli로 명시적으로 호출할 수 있습니다.
이 스킬은 agenteye CLI와 함께 유지 관리되며 AgentEye 패키지의 일부로 배포됩니다. agenteye-cli 폴더가 없다면 AgentEye 담당자에게 문의하세요. 별도로 게이트되어 있지 않습니다. Docker 이미지나 별도 자격 증명이 필요 없으며, 단지 사용자 자신의 대시보드를 대상으로 공개 agenteye CLI를 구동할 뿐입니다.

​
안전 — 에이전트가 CLI를 실행할 때 변경 작업은 확인 프롬프트가 표시되지 않습니다

에이전트가 변경 작업을 수행하도록 허용하기 전에 반드시 읽어주세요. agenteye CLI는 일반적으로 파괴적인 작업 전에 *“정말로 실행하시겠습니까?”*라고 묻습니다. 하지만 터미널에 연결되어 있지 않을 경우 이 확인 과정을 자동으로 건너뛰는데, 코딩 에이전트가 CLI를 실행하는 방식이 바로 그렇습니다. --json 옵션도 확인 과정을 건너뜁니다. 따라서 에이전트에서는 안전 확인 프롬프트가 표시되지 않습니다. 이를 보완하기 위해 스킬은 다음과 같이 동작하도록 설계되었습니다. 실행할 정확한 명령어를 먼저 명시하고, 상태 변경 전에 사용자의 명시적인 승인을 받도록 지시되어 있습니다. 이 원칙을 유지하세요. 에이전트를 통해 AgentEye를 구동할 때 사용자가 바로 확인 단계입니다. 주의해야 할 상태 변경 명령어는 다음과 같습니다:
  • keys create / update / disable / regenerate
  • users create / update / disable / enable
  • settings set
  • alerts create / update / delete / test
  • 쓰기 관련 incidents 하위 명령어: ack / assign / resolve / open / comment-add / comment-delete / subscribe / unsubscribe
  • query create / update / delete
  • agent rename / delete
  • orgs switch
Observe 하위 명령어(events, sessions, evals, errors, list, whoami, orgs list/current/perms)는 모두 읽기 전용이며 아무것도 변경하지 않습니다. 에이전트는 사용자로서 동작하므로 로그인 권한 범위 내에서만 작업을 수행할 수 있습니다. 권한은 조직별로 확인됩니다 (api-keys.md 참고). 권한이 없는 명령어를 실행하면 종료 코드 5와 함께 필요한 권한 이름이 정확히 반환되므로, 에이전트가 불분명한 오류 대신 관리자에게 정확히 무엇을 요청해야 하는지 알려줄 수 있습니다.

​
물어볼 수 있는 내용

이 스킬은 자연어 의도를 적절한 agenteye 명령어로 매핑하며, 추측 없이 먼저 유효한 값을 확인합니다 (list <kind>, whoami):
  • “지난 24시간 동안 문제가 있거나 실패한 게 있어?” → errors --since 24h --aggregate 후 상세 분석 결과 제공.
  • “세션 run-001이 왜 실패했어?” → events --session-id run-001 --all + evals --session-id run-001.
  • “이번 주 품질 추세는 어때?” → evals --aggregate --since 7d 후 낮은 점수 실행에 대한 심층 분석.
  • “CI에 이벤트 푸시만 가능한 키 줘.” → keys create ci --add events:add (명령어를 먼저 명시한 후 생성하고 일회용 시크릿 캡처).
  • “누가 접근 권한이 있어? Dana를 읽기 전용으로 바꿔줘.” → users list → (사용자 확인 후) users update dana@… --permission-set read-only.
  • “발생 중인 인시던트 확인하고 나한테 할당해줘.” → incidents list --state firing → incidents ack <id> / incidents assign <id> you@….
이 내용의 배경이 되는 정확한 명령어, 플래그, JSON 구조는 cli.md와 cli-recipes.md를 참고하세요.

​
참고 자료

  • CLI — agenteye의 전체 명령어 및 플래그 레퍼런스.
  • 에이전트용 CLI 레시피 — 복사하여 바로 사용 가능한 jq 패턴과 종료 코드 처리.
  • AI 어시스턴트 — 대시보드 내 어시스턴트 (이 터미널 스킬과 혼동하지 마세요).
  • API Keys — 스킬이 수행할 수 있는 작업 범위를 결정하는 조직별 권한 모델.