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

# CLI 설치

> 머신에 nora 명령 얻고 로그인.

`nora` CLI 는 Nora 플랫폼과 HTTPS 로 대화하는 단일 바이너리. 앱에서 취할 수 있는 모든 액션이 CLI 등가 있음 — 전체 표면은 [명령 레퍼런스](/ko/cli/reference) 참고.

## 설치

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://install.nora.my | sh
    ```

    `nora` 바이너리를 `~/.nora/bin` 에 설치하고 `PATH` 에 추가 지시 인쇄.

    특정 버전 고정:

    ```bash theme={null}
    curl -fsSL https://install.nora.my | NORA_VERSION=1.4.2 sh
    ```
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew install nora-ai/tap/nora
    ```

    `brew upgrade nora` 로 자동 업그레이드.
  </Tab>

  <Tab title="소스에서 (Rust)">
    ```bash theme={null}
    cargo install nora-cli
    ```

    최근 stable Rust 툴체인 필요. `~/.cargo/bin` 에 로컬 빌드 바이너리 생성.
  </Tab>

  <Tab title="Docker">
    ```bash theme={null}
    docker run --rm -it -v ~/.nora:/root/.nora nora-ai/cli:latest nora --help
    ```

    편의 alias:

    ```bash theme={null}
    alias nora='docker run --rm -it -v ~/.nora:/root/.nora nora-ai/cli:latest nora'
    ```

    바이너리 직접 설치 못할 때 좋음 (락다운 노트북, 일시 CI).
  </Tab>
</Tabs>

검증:

```bash theme={null}
nora --version
```

## 업그레이드

<Tabs>
  <Tab title="설치 스크립트">
    설치 스크립트 재실행 — 최신 fetch.

    ```bash theme={null}
    curl -fsSL https://install.nora.my | sh
    ```
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew upgrade nora
    ```
  </Tab>

  <Tab title="Cargo">
    ```bash theme={null}
    cargo install nora-cli --force
    ```
  </Tab>
</Tabs>

시작 시 CLI 체크: 새 버전 사용 가능하고 여러분 버전이 > 30일이면 한 줄 리마인더 봄. `NORA_NO_UPDATE_CHECK=1` 로 끔.

## 로그인

```bash theme={null}
nora auth login
```

OAuth 위해 브라우저 창 열림. [platform.nora.my](https://platform.nora.my) 에 쓰는 같은 계정으로 로그인.

CI 나 헤드리스 환경은 토큰으로 브라우저 플로우 스킵 — [`nora auth`](/ko/cli/auth) 참고.

자격증명 저장 위치:

* macOS: `~/Library/Application Support/nora/credentials.json`
* Linux: `~/.config/nora/credentials.json`
* Windows: `%APPDATA%\nora\credentials.json`

파일 권한이 `0600` (여러분 읽기 전용). 절대 커밋 안 함.

## 상태 확인

```bash theme={null}
nora auth status
```

활성 워크스페이스, 저장된 워크스페이스, 편집된 토큰 요약 표시. 항상 실행 안전 — 부수 효과 없음.

## 워크스페이스 선택

여러 워크스페이스에 속하면 그 사이 전환:

```bash theme={null}
nora auth workspaces list
nora auth workspaces switch <workspace-id>
```

전환이 지속 — 다시 전환할 때까지 후속 명령이 새 활성 워크스페이스에서 액션.

전환 없이 한 명령만 오버라이드:

```bash theme={null}
nora --workspace <other-id> flows list
```

## Flow 고정

대부분 명령이 하나의 Flow 에 작동. 매번 slug 타이핑 안 하도록 작업 Flow 고정:

```bash theme={null}
nora flows use <flow-slug>
nora flows current   # 고정된 slug 인쇄
```

이제 `nora flows publish`, `nora agents create` 등이 모두 그 Flow 기본.

## 환경 오버라이드

스크립트와 CI 용, 저장된 설정 만지지 않고 오버라이드:

| 변수                | 하는 것                                                 |
| ----------------- | ---------------------------------------------------- |
| `NORA_BASE_URL`   | 서버 origin (기본 `https://platform.nora.my`)            |
| `NORA_TENANT`     | 워크스페이스 오버라이드                                         |
| `NORA_FLOW`       | Flow 오버라이드                                           |
| `NORA_TOKEN`      | 비대화 auth (`nora auth login` 스킵)                      |
| `NORA_CONFIG_DIR` | 대체 설정 디렉토리 (다중 계정용)                                  |
| `NORA_LOG`        | 로그 레벨: `error` / `warn` / `info` / `debug` / `trace` |

전체 목록과 우선순위 룰: [전역 플래그](/ko/cli/global-flags).

## 셸 완성

셸용 완성 스크립트 생성:

```bash theme={null}
# bash
nora completion bash > /etc/bash_completion.d/nora

# zsh
nora completion zsh > "${fpath[1]}/_nora"

# fish
nora completion fish > ~/.config/fish/completions/nora.fish
```

셸 재시작 (또는 파일 `source`).

서브커맨드와 플래그 탭 완성. 원격 데이터 (Flow slug, ID) fetch 안 함 — 추가 왕복 필요; 필요할 때 `--json | jq` 사용.

## 다음 탐색

<CardGroup cols={2}>
  <Card title="Auth 명령" icon="key" href="/ko/cli/auth">
    로그인, 워크스페이스 전환, CI 에서 토큰 사용.
  </Card>

  <Card title="Flow 작업" icon="diagram-project" href="/ko/cli/flows">
    나열, 적용, 배포, 롤백.
  </Card>

  <Card title="전체 명령 레퍼런스" icon="list" href="/ko/cli/reference">
    모든 명령 그룹 한눈에.
  </Card>

  <Card title="파이핑·시크릿" icon="lock" href="/ko/cli/piping-and-secrets">
    시크릿 값과 파일 안전하게 공급.
  </Card>
</CardGroup>