> ## 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.

# 명령 레퍼런스

> 모든 nora 명령 그룹 한눈에.

모든 최상위 명령의 치트시트 인덱스. 각 그룹이 세부 페이지로 링크.

## Setup

| 그룹                                              | 목적                     | 문서                             |
| ----------------------------------------------- | ---------------------- | ------------------------------ |
| `auth`                                          | 로그인, 워크스페이스 전환, 토큰 관리. | [Auth](/ko/cli/auth)           |
| `--base-url`, `--workspace`, `--flow`, `--json` | 전역 플래그.                | [전역 플래그](/ko/cli/global-flags) |

## Flows

| 그룹               | 목적                       | 문서                               |
| ---------------- | ------------------------ | -------------------------------- |
| `flows`          | Flow CRUD, 배포, 롤백, 버전.   | [Flows](/ko/cli/flows)           |
| `flows settings` | Flow 레벨 설정 (승인 웹훅, 기본값). | [Flow 설정](/ko/cli/flow-settings) |
| `vars`           | Flow 레벨 `{{name}}` 변수.   | [Vars](/ko/cli/vars)             |
| `schema`         | BuilderPayload 스키마 인쇄.   | [Schema](/ko/cli/schema)         |

## Blocks

| 그룹         | 목적                            | 문서                           |
| ---------- | ----------------------------- | ---------------------------- |
| `agents`   | Agent 블록 — 프롬프트, 모델, 소스, 메모리. | [Agents](/ko/cli/agents)     |
| `tools`    | Tool 블록 — HTTP/인라인, 파라미터, 헤더. | [Tools](/ko/cli/tools)       |
| `actions`  | Action 블록 — 답변 후 부수 효과.       | [Actions](/ko/cli/actions)   |
| `triggers` | Trigger 블록 — API, 웹훅, 스케줄.    | [Triggers](/ko/cli/triggers) |
| `edges`    | 블록 배선·해제.                     | [Edges](/ko/cli/edges)       |

## Data & knowledge

| 그룹           | 목적                                          | 문서                               |
| ------------ | ------------------------------------------- | -------------------------------- |
| `pipelines`  | Foundry 파이프라인 — 노드, 엣지, 스케줄, 실행, 로그.        | [Pipelines](/ko/cli/pipelines)   |
| `foundry`    | Foundry 유틸리티 (NL → import-conditions 컴파일러). | [Foundry](/ko/cli/foundry)       |
| `documents`  | 라이브러리 문서 — 태그, supersede.                   | [Documents](/ko/cli/documents)   |
| `memory`     | 메모리 스페이스 — 노트, 노드, 엣지, 세션.                  | [Memory](/ko/cli/memory)         |
| `retrieval`  | 검색, 프리셋, 진단.                                | [Retrieval](/ko/cli/retrieval)   |
| `causal`     | 폴더별 인과 그래프 (STAGED/LIVE).                   | [Causal](/ko/cli/causal)         |
| `connectors` | 재사용 외부 시스템 자격증명.                            | [Connectors](/ko/cli/connectors) |

## Reliability

| 그룹          | 목적                            | 문서                             |
| ----------- | ----------------------------- | ------------------------------ |
| `traces`    | 실행 검사, 검증기 트리거.               | [Traces](/ko/cli/traces)       |
| `feedback`  | Thumbs/교정 제출; 외부 웹훅 describe. | [Feedback](/ko/cli/feedback)   |
| `approvals` | 게이트 결정; 웹훅 배선.                | [Approvals](/ko/cli/approvals) |

## Workspace

| 그룹          | 목적                                  | 문서                             |
| ----------- | ----------------------------------- | ------------------------------ |
| `providers` | LLM provider API 키.                 | [Providers](/ko/cli/providers) |
| `models`    | 이 워크스페이스가 고를 수 있는 LLM 나열 (BYOK 필터). | [Models](/ko/cli/models)       |
| `billing`   | 플랜, 사용량, 인보이스, 세금, 초과 캡.            | [Billing](/ko/cli/billing)     |

## Reference

| 그룹    | 목적                                    | 문서                                    |
| ----- | ------------------------------------- | ------------------------------------- |
| 입력 모드 | `?` 프롬프트 / `-` stdin / `@file` / 리터럴. | [파이핑·시크릿](/ko/cli/piping-and-secrets) |

## 흔한 셸 패턴

### Flow 를 git 에 스냅샷

```bash theme={null}
nora flows snapshot support > flows/support.json
git add flows/support.json && git commit -m "sync support flow"
```

### Flow 의 모든 Agent 벌크 업데이트

```bash theme={null}
for id in $(nora flows get support | jq -r '.blocks[] | select(.kind=="agent").id'); do
  nora agents update $id --set-max-cost 0.10
done
```

### 시뮬레이션 게이트 배포

```bash theme={null}
nora flows apply support flows/support.json
if nora providers check support --json | jq -e '.gaps | length > 0' > /dev/null; then
  echo "Provider 키 누락"; exit 1
fi
nora flows publish support --summary "$(git log -1 --pretty=%s)"
```

### 어느 명령에서든 도움말

```bash theme={null}
nora --help
nora agents --help
nora agents update --help
```

`--help` 가 컨텍스트 인식 — 더 깊은 명령이 자체 플래그만 표시.

## 도움말

* **명령이 문서대로 작동 안 함** — 전체 HTTP 추적에 `--verbose` 로 실행.
* **Auth 이슈** — `nora auth status`, 그 다음 재-`login` 또는 `NORA_TOKEN` 설정.
* **잘못된 워크스페이스** — 일회성은 `nora --workspace <id> ...`, 또는 기본 변경은 `nora auth workspaces switch <id>`.
* **다른 모든 것** — 리포에 이슈 파일 또는 [support@conscience.technology](mailto:support@conscience.technology) 이메일.

## 설치·업그레이드

[Install](/ko/cli/install) 참고.