전역 플래그·환경변수

특정 플래그가 모든 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 요청/응답 봄. 서버 쪽 이슈 리포팅에 좋음.

시작

플로우

블록

데이터·지식

신뢰성

워크스페이스

레퍼런스

전역 플래그·환경변수