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

# 명령 레퍼런스

> 모든 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`  | 파운더리 파이프라인. 노드, 엣지, 스케줄, 실행, 로그.        | [Pipelines](/ko/cli/pipelines)   |
| `foundry`    | 파운더리 유틸리티(NL → import-conditions 컴파일러). | [파운더리](/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) 참고.