> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AgentEye CLI Agent Skill

> AgentEye AgentEye CLI Agent Skill 문서.

**AgentEye CLI 스킬** (`agenteye-cli`)은 설치 가능한 *Agent Skill*로, Claude Code, Codex 등 호환 가능한 코딩 에이전트 도구가 자연어 요청을 통해 AgentEye 배포 환경을 [`agenteye` CLI](/ko/agenteye/cli)로 운용할 수 있도록 가르쳐 줍니다. 예를 들어 *"오늘 문제 있는 게 있어?"*, *"CI에 이벤트 푸시만 가능한 키 줘"*, *"발생 중인 인시던트 확인하고 나한테 할당해줘"* 같은 요청이 가능합니다.

이 스킬은 별도 서비스나 바이너리가 **아닙니다**. 이미 설치된 CLI 위에서 동작하는 소형 명령어 번들입니다. 에이전트가 `agenteye --json …` 명령을 실행하고 깔끔한 JSON을 파싱한 뒤 자연어로 결과를 알려줍니다. 스킬이 할 수 있는 모든 것은 동일한 명령어를 직접 입력해도 수행할 수 있습니다.

***

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

AgentEye는 동일한 데이터와 컨트롤에 접근하는 네 가지 방법을 제공하며, 서로 보완적으로 사용할 수 있습니다:

| 인터페이스                                         | 설명                           | 실행 환경                 | 사용 시점                           |
| --------------------------------------------- | ---------------------------- | --------------------- | ------------------------------- |
| **[CLI](/ko/agenteye/cli)**                   | `agenteye` 명령어/플래그 레퍼런스      | 터미널                   | 특정 명령을 직접 실행하거나 스크립트로 작성할 때     |
| **[CLI 레시피](/ko/agenteye/cli-recipes)**       | 복사하여 바로 사용 가능한 `jq`/파이프라인 패턴 | 터미널 / 스크립트            | CLI를 자동화에 연결할 때                 |
| **CLI 스킬** (이 문서)                             | CLI에 자연어 인터페이스를 제공하는 프론트엔드   | 워크스테이션의 코딩 에이전트       | 직접 물어보고 에이전트가 명령어를 선택하게 하고 싶을 때 |
| **[대시보드 내 AI 어시스턴트](/ko/agenteye/assistant)** | 대시보드에 내장된 채팅                 | 클러스터 내부의 `agent` 컨테이너 | 대시보드에서 데이터를 Q\&A 방식으로 조회하고 싶을 때 |

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

두 도구는 영향 범위가 크게 다릅니다:

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

***

## 사전 요구 사항

1. **`agenteye` CLI가 설치**되어 있고 `PATH`에 등록되어 있어야 합니다 ([cli.md](/ko/agenteye/cli) 참고 — `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](/ko/agenteye/api-keys) 참고). 권한이 없는 명령어를 실행하면 종료 코드 `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](/ko/agenteye/cli)와 [cli-recipes.md](/ko/agenteye/cli-recipes)를 참고하세요.

***

## 참고 자료

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