> ## Documentation Index
> Fetch the complete documentation index at: https://v3.selectfromuser.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI 설치하기

SAPP CLI는 로컬에서 개발한 앱을 SAPP 프로젝트와 연결하고, 터미널에서 배포와 프로젝트 운영 작업을 수행할 수 있는 명령줄 도구입니다. SAPP CLI를 설치하면 다음과 같은 작업을 할 수 있습니다.

* 앱 배포 및 업데이트
* 배포 버전 조회 및 롤백
* 프로젝트 API 조회 및 호출
* API 정의(YAML) 관리
* 리소스(DB) 조회 및 SQL 실행
* 프로젝트 회원 관리

## 설치 전 준비

SAPP CLI는 Node.js 환경에서 동작합니다. 먼저 Node.js와 npm이 설치되어 있는지 확인합니다.

```bash theme={null}
node -v
npm -v
```

버전이 출력되지 않는다면 먼저 Node.js를 설치해 주세요.

## 설치하기

다음 명령을 실행하여 SAPP CLI를 설치합니다.

```bash theme={null}
npm install -g @selectfromuser/cli
```

설치가 완료되면 `sapp` 명령을 사용할 수 있습니다.

## 설치 확인

아래 명령을 실행합니다.

```bash theme={null}
sapp
```

CLI 도움말이 출력되면 정상적으로 설치된 것입니다.

## 업데이트

최신 버전으로 업데이트하려면 다음 명령을 실행합니다.

```bash theme={null}
npm install -g @selectfromuser/cli@latest
```

## 제거

CLI를 제거하려면 다음 명령을 실행합니다.

```bash theme={null}
npm uninstall -g @selectfromuser/cli
```

## 문제 해결

### `sapp: command not found`

CLI가 정상적으로 설치되지 않았거나 PATH에 등록되지 않은 경우 발생할 수 있습니다. 먼저 설치 여부를 확인합니다.

```bash theme={null}
npm list -g @selectfromuser/cli
```

설치되어 있지 않다면 다시 설치를 진행합니다.

```bash theme={null}
npm install -g @selectfromuser/cli
```

문제가 계속된다면 터미널을 다시 실행하거나 Node.js 설치 환경을 확인해 보세요.

## 참고 자료

이 문서에서는 설치와 기본 사용 흐름을 설명합니다. 전체 명령어, 옵션, 최신 변경 사항은 SAPP CLI npm 페이지에서 확인할 수 있습니다.

[https://www.npmjs.com/package/@selectfromuser/cli](https://www.npmjs.com/package/@selectfromuser/cli)