전역 플래그·환경변수

일부 플래그는 모든 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는 맥락을 압니다. 더 깊이 갈수록 더 구체적인 도움말이 나옵니다:

nora --help                # 최상위 명령
nora agents --help         # agents 서브커맨드
nora agents update --help  # `agents update`의 모든 플래그

버전

nora --version

CLI 버전, 타겟 플랫폼, 빌드 커밋 해시를 표시합니다. 버그 리포트를 낼 때 넣습니다.

출력 형식

명령 대부분이 두 출력 모드를 지원합니다:

Human(기본) 컬러 테이블과 구조화 텍스트
JSON(--json) 파싱 가능하고 파이프에 좋습니다. 같은 데이터에 서식만 없습니다

jq, 다른 CLI, 스크립트로 파이프할 때는 --json을 씁니다. 예:

nora flows list --json | jq -r '.[].slug'

일부 명령은 기본으로 JSON을 냅니다(flows get, flows snapshot, agents sources list). 내용이 테이블로 잘 안 담기기 때문입니다.

색

TTY를 감지하면 색이 기본으로 켜집니다. 끄려면:

NORA_NO_COLOR=1 nora flows list

또는 cat으로 파이프합니다. 출력이 TTY가 아니면 색이 자동으로 꺼집니다.

디버깅

명령이 이상하게 돌면 verbose 로깅을 켭니다:

nora --verbose flows publish support-agent

또는:

NORA_LOG=debug nora flows publish support-agent

토큰을 가린 헤더와 함께 전체 HTTP 요청/응답을 봅니다. 서버 쪽 이슈를 알릴 때 좋습니다.

CLI

SDK

Local App

전역 플래그·환경변수