전역 플래그·환경변수

일부 플래그는 모든 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 요청/응답을 봄. 서버 쪽 이슈를 알릴 때 좋음.

시작

플로우

블록

데이터·지식

신뢰성

워크스페이스

레퍼런스

전역 플래그·환경변수