diff --git a/src/content/docs/ko/how-it-works/cli.mdx b/src/content/docs/ko/how-it-works/cli.mdx
index f8bf3d66..1ad8895f 100644
--- a/src/content/docs/ko/how-it-works/cli.mdx
+++ b/src/content/docs/ko/how-it-works/cli.mdx
@@ -4,92 +4,119 @@ title: "CLI"
description: "StudioCMS CLI와 사용법에 대해 알아보세요."
sidebar:
order: 2
+ badge:
+ text: '업데이트됨'
+ variant: 'success'
+tableOfContents:
+ minHeadingLevel: 2
+ maxHeadingLevel: 4
---
import { Tabs, TabItem } from '@astrojs/starlight/components';
import ReadMore from '~/components/ReadMore.astro';
-# 소개
-
StudioCMS CLI는 새로운 StudioCMS 프로젝트를 빠르게 구성하고 StudioCMS에 유용한 유틸리티를 제공하는 도구입니다.
-StudioCMS 생태계에는 두 가지 서로 다른 CLI가 있습니다.
+StudioCMS 생태계에는 서로 다른 여러 CLI가 있습니다.
-- **`create-studiocms`**: StudioCMS 프로젝트 스캐폴딩 CLI
-- **`studiocms`**: StudioCMS 유틸리티 CLI
+- **[`create-studiocms`](#create-studiocms)**: StudioCMS 프로젝트 스캐폴딩 CLI
+- **[`studiocms`](#studiocms)**: StudioCMS 유틸리티 CLI
+- **[`@studiocms/upgrade`](#studiocms-upgrade)**: StudioCMS 프로젝트 및 플러그인 업그레이드
다음은 StudioCMS CLI와 그 구성 요소에 대한 세부 정보입니다.
-## `create-studiocms`
+## `studiocms`
-### 설치
+### CLI 옵션 및 명령어 전체 목록
-
-
- ```sh
- npm create studiocms@latest
- ```
-
-
- ```sh
- pnpm create studiocms
- ```
-
-
- ```sh
- yarn create studiocms
- ```
-
-
+```log
+Usage: studiocms [options] [command]
-`create-studiocms`는 기본적으로 _대화형_ 모드로 실행되지만, 명령줄 인수를 사용하여 프로젝트 이름과 템플릿을 지정할 수도 있습니다.
+Options:
+ -V, --version Output the current version of the CLI Toolkit.
+ -h, --help display help for command
+ --color force color output
+ --no-color disable color output
+
+Commands:
+ add Add StudioCMS plugin(s) to your project
+ crypto Crypto Utilities for Security
+ get-turso Install the Turso CLI
+ init Initialize the StudioCMS project after new installation.
+ users Utilities for Tweaking Users in StudioCMS
+```
+
+### 사용법 예시
+
+StudioCMS 프로젝트 루트에서 다음을 실행합니다.
```sh
- npm create studiocms@latest -- --template studiocms/basics --project-name my-studiocms-project
+ npm run studiocms [command]
```
```sh
- pnpm create studiocms --template studiocms/basics --project-name my-studiocms-project
+ pnpm studiocms [command]
```
```sh
- yarn create studiocms --template studiocms/basics --project-name my-studiocms-project
+ yarn studiocms [command]
```
-GitHub에서 제공되는 템플릿의 [전체 목록][templates]을 확인해 보세요.
+### 명령어 알아보기
-`--template`을 사용할 때 CLI는 템플릿 리포지토리의 모든 폴더를 검색합니다. 예를 들어, `studiocms/basics` 템플릿은 리포지토리 루트의 `studiocms` 폴더에 있는 `basics` 프로젝트를 가리킵니다.
+#### `add`
-### 전체 CLI 옵션 및 명령
+```log
+usage: studiocms add
+
+Adds StudioCMS plugin(s) to your project.
+
+Arguments:
+ plugins Plugin(s) to install
+
+Options:
+ -h, --help display help for command
+```
-#### 기본 진입점
+#### `crypto`
```log
-Usage: create-studiocms [options] [command]
+usage: studiocms crypto [command]
+
+Crypto Utilities for Security
Options:
- -V, --version Output the current version of the CLI Toolkit.
- -h, --help display help for command
- --color force color output
- --no-color disable color output
+ -h, --help display help for command
Commands:
- get-turso Get the latest version of Turso.
- help Show help for command
- interactive* Start the interactive CLI.
+ gen-jwt Generate JWT token from a keyfile
+```
- * Indicates the default command that is run when calling this CLI.
+#### `crypto gen-jwt`
+
+```log
+usage: studiocms crypto gen-jwt [options]
+
+Generate a JWT token from a keyfile
+
+Arguments:
+ key-file a relative path (e.g., `../keys/libsql.pem`) from the current directory to your private key file (.pem)
+
+Options:
+ -c, --claim claim in the form [key=value]
+ -e, --exp Expiry date in seconds (>=0) from issued at (iat) time
+ -h, --help display help for command
```
#### `get-turso`
-Turso의 [문서](https://docs.turso.tech/cli/installation)에 있는 스크립트를 사용하여 Turso의 최신 버전을 다운로드하고 설치할 수 있습니다.
+Turso의 [문서][turso-docs]에 있는 스크립트를 사용하여 최신 버전의 Turso를 다운로드하고 설치합니다.
:::note
Turso에 따르면 Windows에서는 WSL을 사용해야 합니다.
@@ -104,6 +131,112 @@ Options:
-h, --help display help for command
```
+#### `init`
+
+```log
+Usage: studiocms init [options]
+
+Initialize the StudioCMS project after new installation.
+
+Options:
+ -d, --dry-run Dry run mode
+ --skip-banners Skip all banners
+ --debug Enable debug mode
+ -h, --help Display help for command
+```
+
+init 명령어는 다음을 도와주는 대화형 설정 경험을 제공합니다.
+
+1. 다음 옵션을 통해 환경 파일 (.env)을 설정합니다.
+ - `.env` 템플릿 예시 사용
+ - 대화형 `.env` 빌더 사용 (다음 기능 포함):
+ - 새로운 Turso 데이터베이스 설정 (Windows가 아닌 경우)
+ - OAuth 제공자 구성 (GitHub, Discord, Google, Auth0)
+ - 암호화 키 및 기타 필수 변수 설정
+ - 환경 파일 생성 건너뛰기
+
+2. 데이터베이스 설정 시 필요한 경우 Turso CLI 자동 설치 및 인증을 포함합니다.
+
+전체 환경 변수 목록은 [환경 변수 문서][environment-variables]를 참조하세요.
+
+#### `users`
+
+```log
+usage: studiocms users [options]
+
+Utilities for Tweaking Users in StudioCMS
+
+Options:
+ -h, --help display help for command
+```
+
+## `create-studiocms`
+
+### CLI 옵션 및 명령어 전체 목록
+
+```log
+Usage: create-studiocms [options] [command]
+
+Options:
+ -V, --version Output the current version of the CLI Toolkit.
+ -h, --help display help for command
+ --color force color output
+ --no-color disable color output
+
+Commands:
+ get-turso Get the latest version of Turso.
+ help Show help for command
+ interactive* Start the interactive CLI.
+
+ * Indicates the default command that is run when calling this CLI.
+```
+
+### 사용법 예시
+
+
+
+ ```sh
+ npm create studiocms@latest
+ ```
+
+
+ ```sh
+ pnpm create studiocms
+ ```
+
+
+ ```sh
+ yarn create studiocms
+ ```
+
+
+
+`create-studiocms`는 기본적으로 _대화형_ 모드로 실행되지만, 명령줄 인수를 사용하여 프로젝트 이름과 템플릿을 지정할 수도 있습니다.
+
+
+
+ ```sh
+ npm create studiocms@latest -- --template studiocms/basics --project-name my-studiocms-project
+ ```
+
+
+ ```sh
+ pnpm create studiocms --template studiocms/basics --project-name my-studiocms-project
+ ```
+
+
+ ```sh
+ yarn create studiocms --template studiocms/basics --project-name my-studiocms-project
+ ```
+
+
+
+GitHub에서 제공되는 템플릿의 [전체 목록][templates]을 확인해 보세요.
+
+`--template`을 사용할 때 CLI는 템플릿 리포지토리의 모든 폴더를 검색합니다. 예를 들어, `studiocms/basics` 템플릿은 리포지토리 루트의 `studiocms` 폴더에 있는 `basics` 프로젝트를 가리킵니다.
+
+### 명령어 알아보기
+
#### 대화형 (기본 명령)
```log
@@ -130,30 +263,9 @@ Options:
--do-not-init-git Do not initializing a git repository.
```
-## `studiocms`
-
-### 전체 CLI 옵션 및 명령
-
-#### 기본 진입점
-
-```log
-Usage: studiocms [options] [command]
-
-Options:
- -V, --version Output the current version of the CLI Toolkit.
- -h, --help display help for command
- --color force color output
- --no-color disable color output
-
-Commands:
- get-turso Get the latest version of Turso.
- help Show help for command
- init Initialization Tools.
-```
-
#### `get-turso`
-Turso [문서](https://docs.turso.tech/cli/installation)의 스크립트를 사용하여 Turso의 최신 버전을 다운로드하고 설치합니다.
+Turso의 [문서][turso-docs]에 있는 스크립트를 사용하여 최신 버전의 Turso를 다운로드하고 설치합니다.
:::note
Turso에 따르면 Windows에서는 WSL을 사용해야 합니다.
@@ -168,48 +280,56 @@ Options:
-h, --help display help for command
```
-#### `init`
+## `@studiocms-upgrade`
-```log
-Usage: studiocms init [options]
+StudioCMS 설치 및 의존성을 업그레이드하기 위한 명령줄 도구입니다.
-Initialize the StudioCMS project after new installation.
+터미널에서 이 명령을 실행하여 StudioCMS를 업그레이드하는 동시에 공식 Astro 프로젝트와 통합을 함께 업그레이드할 수 있습니다.
-Options:
- -d, --dry-run Dry run mode
- --skip-banners Skip all banners
- --debug Enable debug mode
- -h, --help Display help for command
-```
+### 사용법 예시
-init 명령어는 다음을 도와주는 대화형 설정 경험을 제공합니다.
-
-1. 다음 옵션을 통해 환경 파일 (.env)을 설정합니다.
- - `.env` 템플릿 예시 사용
- - 대화형 `.env` 빌더 사용 (다음 기능 포함):
- - 새로운 Turso 데이터베이스 설정 (Windows가 아닌 경우)
- - OAuth 제공자 구성 (GitHub, Discord, Google, Auth0)
- - 암호화 키 및 기타 필수 변수 설정
- - 환경 파일 생성 건너뛰기
-
-2. 데이터베이스 설정 시 필요한 경우 Turso CLI 자동 설치 및 인증을 포함합니다.
-
-## 환경 변수
-
-StudioCMS는 여러 환경 변수를 구성해야 합니다. 주요 변수는 다음과 같습니다.
+
+
+ ```sh
+ npx @studiocms/upgrade
+ ```
+
+
+ ```sh
+ pnpm dlx @studiocms/upgrade
+ ```
+
+
+ ```sh
+ yarn dlx @studiocms/upgrade
+ ```
+
+
-```dotenv
-# 데이터베이스 구성
-ASTRO_DB_REMOTE_URL=libsql://your-database.turso.io
-ASTRO_DB_APP_TOKEN=your-token
+### 옵션
-# 인증 구성
-CMS_ENCRYPTION_KEY="..." # openssl rand --base64 16 명령으로 생성
-```
+#### 태그 (선택 사항)
-전체 환경 변수 목록은 [환경 변수 문서][environment-variables]를 참조하세요.
+특정 `tag`를 전달하여 패키지를 해석할 수도 있습니다. 포함하지 않으면 `@studiocms/upgrade`는 `latest` 태그를 찾습니다.
-`studiocms init` 명령의 대화형 환경 빌더를 사용하여 이러한 변수를 설정할 수 있습니다.
+
+
+ ```sh
+ npx @studiocms/upgrade beta
+ ```
+
+
+ ```sh
+ pnpm dlx @studiocms/upgrade beta
+ ```
+
+
+ ```sh
+ yarn dlx @studiocms/upgrade beta
+ ```
+
+
+[turso-docs]: https://docs.turso.tech/cli/installation
[templates]: https://github.com/withstudiocms/templates
[environment-variables]: /ko/start-here/environment-variables/