> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 요청/응답을 봄. 서버 쪽 이슈를 알릴 때 좋음.