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

# 전역 플래그·환경변수

> 모든 명령이 수용하는 플래그와 CLI 가 읽는 환경변수.

특정 플래그가 모든 `nora` 서브커맨드에서 사용 가능. 그것들이 하는 모든 것을 환경변수로도 설정 가능 — 워크플로우에 맞는 것 선택.

## 전역 플래그

| 플래그                | Env var          | 설명                                         |
| ------------------ | ---------------- | ------------------------------------------ |
| `--base-url <url>` | `NORA_BASE_URL`  | 서버 origin. 기본: `https://platform.nora.my`. |
| `--workspace <id>` | `NORA_TENANT`    | 이 명령의 활성 워크스페이스 오버라이드.                     |
| `--flow <slug>`    | `NORA_FLOW`      | 이 명령의 활성 Flow 오버라이드.                       |
| `--json`           | —                | 출력을 JSON 으로 방출 (포맷 선택 지원하는 명령에서).          |
| `--quiet` / `-q`   | —                | 상태 출력 억제; 결과만 인쇄.                          |
| `--verbose` / `-v` | `NORA_LOG=debug` | 요청/응답 추적 표시.                               |
| `-h`, `--help`     | —                | 현재 명령의 도움말 인쇄.                             |
| `--version`        | —                | CLI 버전 인쇄.                                 |

우선순위: 플래그 > env var > 활성 워크스페이스/Flow > CLI 기본.

## 환경변수

전체 목록:

| 변수                           | 목적                                                |
| ---------------------------- | ------------------------------------------------- |
| `NORA_TOKEN`                 | Auth 토큰 (개인이나 워크스페이스). `auth login` 스킵.           |
| `NORA_BASE_URL`              | 서버 URL.                                           |
| `NORA_TENANT`                | 활성 워크스페이스 오버라이드.                                  |
| `NORA_FLOW`                  | 활성 Flow 오버라이드.                                    |
| `NORA_CONFIG_DIR`            | 설정/자격증명 디렉토리.                                     |
| `NORA_LOG`                   | 로그 레벨: `error`, `warn`, `info`, `debug`, `trace`. |
| `NORA_NO_COLOR`              | 어느 값이든 설정하면 ANSI 색 비활성.                           |
| `EDITOR`                     | `agents edit`, `tools edit` 등이 쓰는 에디터.            |
| `HTTPS_PROXY` / `HTTP_PROXY` | CLI 용 HTTP 프록시.                                   |

## 우선순위 룰

가정:

* 셸에 `NORA_TENANT=acme-prod`.
* `nora auth workspaces current` 이 `acme-dev` 반환.
* `nora --workspace acme-staging flows list` 실행.

`--workspace` 플래그가 이김. 이 한 명령이 `acme-staging` 히트. env var 와 활성 워크스페이스 변경 없음.

`--flow` 도 같은 로직.

## 도움말

`--help` 는 컨텍스트 인식 — 더 깊이 갈수록 더 특정한 도움말:

```bash theme={null}
nora --help                # 최상위 명령
nora agents --help         # agents 서브커맨드
nora agents update --help  # `agents update` 의 모든 플래그
```

## 버전

```bash theme={null}
nora --version
```

CLI 버전, 타겟 플랫폼, 빌드의 커밋 해시 인쇄. 버그 리포트 파일링 시 포함.

## 출력 포맷

대부분 명령이 두 출력 모드 지원:

* **Human** (기본) — 컬러 테이블과 구조화 텍스트.
* **JSON** (`--json`) — 파싱 가능, 파이프 친화. 같은 데이터, 포맷팅 없음.

`jq`, 다른 CLI, 스크립트로 파이핑하는 것에는 `--json` 사용.

예:

```bash theme={null}
nora flows list --json | jq -r '.[].slug'
```

일부 명령이 기본으로 JSON 방출 (`flows get`, `flows snapshot`, `agents sources list`) — 콘텐츠가 쉽게 테이블화 안 되어서.

## 색

TTY 감지하면 색이 기본 켜짐. 끄기:

```bash theme={null}
NORA_NO_COLOR=1 nora flows list
```

또는 `cat` 으로 파이프 — 출력이 TTY 아니면 색 자동 비활성.

## 디버깅

명령이 오작동하면 verbose 로깅 켜기:

```bash theme={null}
nora --verbose flows publish support-agent
```

또는:

```bash theme={null}
NORA_LOG=debug nora flows publish support-agent
```

토큰 편집된 헤더 포함 전체 HTTP 요청/응답 봄. 서버 쪽 이슈 리포팅에 좋음.