---
title: "alpacon event watch"
description: "CLI에서 Alpacon 이벤트를 중단할 때까지 연속으로 확인합니다. 이벤트 타입과 대상 ID를 지정하고 한 건당 한 줄로 나오는 출력이나 스크립트용 NDJSON을 선택하세요. 표준 출력과 표준 오류의 구분, 연결이 끊겼을 때 자동 재연결과 이벤트 유실 범위도 안내합니다."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# alpacon event watch

명령을 중단할 때까지 Alpacon 이벤트를 연속으로 출력합니다.

## 사용법

`alpacon event watch [flags]`

## 핵심 사항

- `--type` 필수, 대상이 필요한 이벤트 타입은 `--target`으로 리소스 지정
- 이벤트는 표준 출력에 한 줄씩, 상태 메시지는 표준 오류에 출력
- `--output json`으로 NDJSON 출력, Ctrl+C로 중단

## 플래그

| 플래그 | 유형 | 설명 | 기본값 |
| --- | --- | --- | --- |
| `-h, --help` | `bool` | 명령 도움말 표시 | `false` |
| `--target` | `string` | 대상 리소스 ID. 대상 없는 구독을 허용하는 경우에만 생략 가능 | — |
| `--type` | `string` | 구독할 이벤트 타입. 예: `work_session`. 필수 | — |
| `--output` | `string` | 출력 형식: `table` 또는 `json`. 상위 명령에서 상속 | `table` |

## 예제

작업 세션 이벤트 확인

```bash
alpacon event watch --type work_session --target a1b2c3d4-5678-abcd-ef01-234567890abc
```

스크립트용 NDJSON 출력

```bash
alpacon event watch --type notification --output json
```

## 출력

이벤트 한 건마다 stdout에 한 줄이 나가고, 상태 메시지나 경고 같은 나머지는 모두 stderr로 나갑니다. 파이프로 넘겨도 스트림을 기계가 그대로 읽을 수 있습니다.

기본 `table` 형식은 탭으로 구분된 네 필드, 곧 수신 시각, 이벤트 타입, 서브 타입, `--target`으로 넘긴 대상을 출력합니다. 서브 타입과 대상은 이벤트에 값이 없으면 `-`로 나옵니다.

```
14:32:07	work_session	approved	a1b2c3d4-5678-abcd-ef01-234567890abc
```

이 줄은 14시 32분 7초에 작업 세션 `a1b2c3d4-…`가 승인됐다는 뜻입니다.

`--output json`을 쓰면 이벤트 한 건을 한 줄로 압축한 NDJSON이 나옵니다. 서버가 보낸 필드는 CLI가 모르는 것까지 전부 남습니다. 한 줄에 한 건이라 스트림이 끝나기를 기다리지 않고 오는 대로 읽을 수 있습니다.

```bash
alpacon event watch --type work_session --target a1b2c3d4-5678-abcd-ef01-234567890abc --output json | while read -r event; do
  echo "$event" | jq -r '.payload.sub_type'
done
```

## 재연결

연결이 끊기면 자동으로 다시 붙고, 재연결과 재연결 실패는 stderr로 알립니다. 끊긴 동안 발행된 이벤트는 유실됩니다. 채널에 다시 재생할 히스토리가 없기 때문입니다.

연결이 15초 안에 열리지 않으면 오류와 함께 종료합니다.

## 대상 ID 찾기

[alpacon work-session ls](/reference/cli/work-session/ls/)를 실행하거나 Alpacon 콘솔에서 확인하세요.

Source: https://docs.alpacax.com/ko/reference/cli/event/watch/