CLI 설치

Nora CLI는 Nora 플랫폼과 HTTPS로 통신하는 단일 바이너리입니다. 앱에서 하는 모든 액션에 CLI 등가물이 있습니다. 전체 표면은 명령 레퍼런스를 참고하세요.

터미널 대신 코딩 에이전트(Claude Desktop, Cursor)를 쓴다면 같은 작업을 MCP 서버로 할 수 있습니다. 자세한 내용은 MCP: 코딩 에이전트를 참고하세요.

설치

macOS / Linux
Homebrew
소스에서 (Rust)
Docker

curl -fsSL https://install.nora.my | sh

nora 바이너리를 ~/.nora/bin에 설치하고 PATH 추가 방법을 출력합니다.특정 버전 고정:

curl -fsSL https://install.nora.my | NORA_VERSION=1.4.2 sh

brew install nora-ai/tap/nora

brew upgrade nora로 업그레이드합니다.

cargo install nora-cli

최근 stable Rust 툴체인이 필요합니다. ~/.cargo/bin에 로컬 빌드 바이너리를 생성합니다.

docker run --rm -it -v ~/.nora:/root/.nora nora-ai/cli:latest nora --help

편의 alias:

alias nora='docker run --rm -it -v ~/.nora:/root/.nora nora-ai/cli:latest nora'

바이너리를 직접 못 깔 때 좋습니다(락다운 노트북, 일시 CI).

확인:

nora --version

업그레이드

설치 스크립트
Homebrew
Cargo

설치 스크립트를 다시 실행해 최신 버전을 받습니다.

curl -fsSL https://install.nora.my | sh

brew upgrade nora

cargo install nora-cli --force

CLI는 시작할 때 점검합니다. 새 버전이 있고 여러분 버전이 30일 넘었으면 한 줄 리마인더가 뜹니다. NORA_NO_UPDATE_CHECK=1로 끕니다.

상태 확인

nora auth status

활성 워크스페이스, 저장된 워크스페이스, 가려진 토큰 요약을 표시합니다. 언제 실행해도 안전합니다(부수 효과 없음).

워크스페이스 선택

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

nora auth workspaces list
nora auth workspaces switch <workspace-id>

전환은 지속됩니다. 다시 전환할 때까지 이후 명령이 새 활성 워크스페이스에서 동작합니다. 전환 없이 한 명령만 덮어쓰기:

nora --workspace <other-id> flows list

Flow 고정

명령 대부분이 Flow 하나에 동작합니다. 매번 slug를 안 치도록 작업 Flow를 고정합니다:

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`

전체 목록과 우선순위 룰은 전역 플래그를 참고하세요.

셸 완성

셸용 완성 스크립트를 생성합니다:

# 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)는 가져오지 않습니다. 왕복이 더 드니, 필요할 때 --json | jq를 씁니다.

다음 탐색

Auth 명령

로그인, 워크스페이스 전환, CI에서 토큰 쓰기.

Flow 작업

나열, 적용, 배포, 롤백.

전체 명령 레퍼런스

모든 명령 그룹을 한눈에.

파이핑·시크릿

시크릿 값과 파일을 안전하게 공급.

CLI

SDK

Local App

설치

업그레이드

로그인

상태 확인

워크스페이스 선택

Flow 고정

환경 덮어쓰기

셸 완성

다음 탐색

Auth 명령

Flow 작업

전체 명령 레퍼런스

파이핑·시크릿

​설치

​업그레이드

​로그인

​상태 확인

​워크스페이스 선택

​Flow 고정

​환경 덮어쓰기

​셸 완성

​다음 탐색

Auth 명령

Flow 작업

전체 명령 레퍼런스

파이핑·시크릿

설치

업그레이드

로그인

상태 확인

워크스페이스 선택

Flow 고정

환경 덮어쓰기

셸 완성

다음 탐색