@intlayer/docs 7.2.2 → 7.3.0-canary.0

package/docs/ko/cli/fill.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: 사전 채우기
+description: AI를 사용하여 사전을 채우고, 감사하며, 번역하는 방법을 알아보세요.
+keywords:
+  - 채우기
+  - 감사
+  - 번역
+  - 사전
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - fill
+---
+
+# 사전 채우기 / 감사 / 번역
+
+```bash
+npx intlayer fill
+```
+
+이 명령어는 누락된 번역, 구조적 불일치 또는 타입 불일치와 같은 잠재적인 문제를 찾기 위해 콘텐츠 선언 파일을 분석합니다. 문제가 발견되면, **intlayer fill**은 사전을 일관되고 완전하게 유지하기 위해 업데이트를 제안하거나 적용합니다.
+
+## 별칭:
+
+- `npx intlayer dictionaries fill`
+- `npx intlayer dictionary fill`
+- `npx intlayer dic fill`
+
+## 인자:
+
+**파일 목록 옵션:**
+
+- **`-f, --file [files...]`**: 감사할 특정 콘텐츠 선언 파일 목록입니다. 제공하지 않으면 구성 파일 설정에 따라 발견된 모든 `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` 파일이 감사됩니다.
+
+  > 예시: `npx intlayer dictionary fill -f src/home/app.content.ts`
+
+- **`-k, --keys [keys...]`**: 키를 기준으로 사전을 필터링합니다. 제공하지 않으면 모든 사전이 감사됩니다.
+
+  > 예시: `npx intlayer dictionary fill -k key1 key2`
+
+- **`--key [keys...]`**: 키를 기준으로 사전을 필터링합니다 (--keys의 별칭).
+
+  > 예시: `npx intlayer dictionary fill --key key1 key2`
+
+- **`--excluded-keys [excludedKeys...]`**: 키를 기준으로 사전을 제외합니다. 제공하지 않으면 모든 사전이 감사됩니다.
+
+  > 예시: `npx intlayer dictionary fill --excluded-keys key1 key2`
+
+- **`--excluded-key [excludedKeys...]`**: 키를 기준으로 사전을 제외합니다 (--excluded-keys의 별칭).
+
+  > 예시: `npx intlayer dictionary fill --excluded-key key1 key2`
+
+- **`--path-filter [pathFilters...]`**: 파일 경로에 대한 glob 패턴을 기준으로 사전을 필터링합니다.
+
+  > 예시: `npx intlayer dictionary fill --path-filter "src/home/**"`
+
+**엔트리 출력 옵션:**
+
+- **`--source-locale [sourceLocale]`**: 번역할 소스 로케일입니다. 지정하지 않으면 구성 파일의 기본 로케일이 사용됩니다.
+
+- **`--output-locales [outputLocales...]`**: 번역 대상 로케일입니다. 지정하지 않으면 소스 로케일을 제외한 구성 파일의 모든 로케일이 사용됩니다.
+
+- **`--mode [mode]`**: 번역 모드: `complete`, `review`. 기본값은 `complete`입니다. `complete`는 누락된 모든 내용을 채우고, `review`는 누락된 내용을 채우고 기존 키를 검토합니다.
+
+**Git 옵션:**
+
+- **`--git-diff`**: 기본 브랜치(기본값 `origin/main`)에서 현재 브랜치(기본값 `HEAD`)로 변경된 사전만 실행합니다.
+- **`--git-diff-base`**: git diff의 기준 참조를 지정합니다 (기본값 `origin/main`).
+- **`--git-diff-current`**: git diff의 현재 참조를 지정합니다 (기본값 `HEAD`).
+- **`--uncommitted`**: 커밋되지 않은 변경 사항을 포함합니다.
+- **`--unpushed`**: 푸시되지 않은 변경 사항을 포함합니다.
+- **`--untracked`**: 추적되지 않은 파일을 포함합니다.
+
+  > 예시: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > 예시: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+**AI 옵션:**
+
+- **`--model [model]`**: 번역에 사용할 AI 모델 (예: `gpt-3.5-turbo`).
+- **`--provider [provider]`**: 번역에 사용할 AI 제공자.
+- **`--temperature [temperature]`**: AI 모델의 온도 설정.
+- **`--api-key [apiKey]`**: AI 서비스에 사용할 API 키 제공.
+- **`--custom-prompt [prompt]`**: 번역 지침을 위한 커스텀 프롬프트 제공.
+- **`--application-context [applicationContext]`**: AI 번역에 추가 컨텍스트 제공.
+
+  > 예시: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**환경 변수 옵션:**
+
+- **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
+- **`--env-file [envFile]`**: 변수를 로드할 사용자 정의 환경 파일을 제공합니다.
+
+  > 예시: `npx intlayer fill --env-file .env.production.local`
+
+  > 예시: `npx intlayer fill --env production`
+
+**구성 옵션:**
+
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다.
+
+  > 예시: `npx intlayer fill --base-dir ./src`
+
+- **`--no-cache`**: 캐시를 비활성화합니다.
+
+  > 예시: `npx intlayer build --no-cache`
+
+**준비 옵션:**
+
+- **`--build`**: 푸시 전에 사전을 빌드하여 콘텐츠가 최신 상태인지 확인합니다. true는 빌드를 강제 실행하며, false는 빌드를 건너뛰고, undefined는 빌드 캐시를 사용할 수 있도록 합니다.
+
+- **`--skip-metadata`**: 사전의 누락된 메타데이터(설명, 제목, 태그) 채우기를 건너뜁니다.
+
+**로그 옵션:**
+
+- **`--verbose`**: 디버깅을 위한 상세 로그를 활성화합니다. (CLI 기본값은 true)
+
+## 예시:
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+이 명령어는 `src/home/` 디렉토리 내 모든 콘텐츠 선언 파일에 대해 GPT-3.5 Turbo 모델을 사용하여 영어에서 프랑스어 및 스페인어로 콘텐츠를 번역합니다.

package/docs/ko/cli/index.md

@@ -0,0 +1,163 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: CLI
+description: Intlayer CLI를 사용하여 다국어 웹사이트를 관리하는 방법을 알아보세요. 이 온라인 문서의 단계를 따라 몇 분 만에 프로젝트를 설정할 수 있습니다.
+keywords:
+  - CLI
+  - 명령줄 인터페이스
+  - 국제화
+  - 문서
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - cli
+history:
+  - version: 7.2.3
+    date: 2025-11-22
+    changes: transform 명령어 추가
+  - version: 7.1.0
+    date: 2025-11-05
+    changes: translate 명령어에 skipIfExists 옵션 추가
+  - version: 6.1.4
+    date: 2025-01-27
+    changes: CLI 인수 및 명령어에 별칭 추가
+  - version: 6.1.3
+    date: 2025-10-05
+    changes: 명령어에 build 옵션 추가
+  - version: 6.1.2
+  date: 2025-09-26
+  changes: version 명령어 추가
+- version: 6.1.0
+  date: 2025-09-26
+  changes: CLI를 사용하여 verbose 옵션의 기본값을 true로 설정
+- version: 6.1.0
+  date: 2025-09-23
+  changes: watch 명령어 및 with 옵션 추가
+- version: 6.0.1
+  date: 2025-09-23
+  changes: editor 명령어 추가
+- version: 6.0.0
+  date: 2025-09-17
+  changes: content test 및 list 명령어 추가
+- version: 5.5.11
+  date: 2025-07-11
+  changes: CLI 명령어 매개변수 문서 업데이트
+- version: 5.5.10
+  date: 2025-06-29
+  changes: 히스토리 초기화
+---
+
+# Intlayer CLI
+
+---
+
+## 목차
+
+<TOC/>
+
+---
+
+## 패키지 설치
+
+npm을 사용하여 필요한 패키지를 설치하세요:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> `intlayer` 패키지가 이미 설치되어 있다면, CLI는 자동으로 설치됩니다. 이 단계는 건너뛸 수 있습니다.
+
+## intlayer-cli 패키지
+
+`intlayer-cli` 패키지는 여러분의 [intlayer 선언](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)을 사전(dictionaries)으로 변환하기 위한 도구입니다.
+
+이 패키지는 `src/**/*.content.{ts|js|mjs|cjs|json}`와 같은 모든 intlayer 파일을 변환합니다. [Intlayer 선언 파일을 선언하는 방법을 확인하세요](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+intlayer 사전을 해석하려면 [react-intlayer](https://www.npmjs.com/package/react-intlayer) 또는 [next-intlayer](https://www.npmjs.com/package/next-intlayer)와 같은 인터프리터를 사용할 수 있습니다.
+
+## 구성 파일 지원
+
+Intlayer는 여러 구성 파일 형식을 지원합니다:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+사용 가능한 로케일이나 기타 매개변수를 구성하는 방법은 [구성 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참조하세요.
+
+## intlayer 명령 실행
+
+### 핵심 명령
+
+- **[사전 빌드](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/build.md)** - 콘텐츠 선언 파일에서 사전을 빌드합니다.
+- **[사전 감시](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/watch.md)** - 변경 사항을 감시하고 자동으로 사전을 빌드합니다.
+- **[CLI 버전 확인](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/version.md)** - 설치된 Intlayer CLI 버전을 확인합니다.
+
+### 사전 관리
+
+- **[사전 푸시](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/push.md)** - 사전을 Intlayer 에디터와 CMS로 푸시합니다.
+- **[사전 가져오기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/pull.md)** - Intlayer 에디터와 CMS에서 사전을 가져옵니다
+- **[사전 채우기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/fill.md)** - AI를 사용하여 사전을 채우고, 감사하며, 번역합니다
+- **[누락된 번역 테스트](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/test.md)** - 누락된 번역을 테스트하고 식별합니다
+- **[콘텐츠 선언 파일 목록](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/list.md)** - 프로젝트 내 모든 콘텐츠 선언 파일을 나열합니다
+
+### 컴포넌트 관리
+
+- **[컴포넌트 변환](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/transform.md)** - 기존 컴포넌트를 Intlayer를 사용하도록 변환
+
+### 구성
+
+- **[구성 관리](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/configuration.md)** - Intlayer 구성을 CMS에서 가져오고 푸시
+
+### 문서 관리
+
+- **[문서 번역](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/doc-translate.md)** - AI를 사용하여 문서 파일 자동 번역
+- **[문서 검토](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/doc-review.md)** - 품질과 일관성을 위한 문서 파일 검토
+
+### 에디터 및 라이브 동기화
+
+- **[에디터 명령어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/editor.md)** - Intlayer 에디터 명령어 사용하기
+- **[라이브 싱크 명령어](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/live.md)** - 런타임에 CMS 콘텐츠 변경 사항을 반영하는 라이브 싱크 사용하기
+
+### 개발 도구
+
+- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/sdk.md)** - 자신의 코드에서 Intlayer CLI SDK 사용하기
+- **[Intlayer 명령어 디버그](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/debug.md)** - Intlayer CLI 문제 디버그 및 문제 해결하기
+
+## `package.json`에서 intlayer 명령어 사용하기
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer build",
+  "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:push": "npx intlayer push",
+  "intlayer:pull": "npx intlayer pull",
+  "intlayer:fill": "npx intlayer fill",
+  "intlayer:list": "npx intlayer content list",
+  "intlayer:test": "npx intlayer content test",
+  "intlayer:transform": "npx intlayer transform",
+  "intlayer:doc:translate": "npx intlayer doc translate",
+  "intlayer:doc:review": "npx intlayer doc review"
+}
+```
+
+> **참고**: 다음과 같은 짧은 별칭도 사용할 수 있습니다:
+>
+> - `npx intlayer list` 는 `npx intlayer content list` 대신 사용
+> - `npx intlayer test` 는 `npx intlayer content test` 대신 사용

package/docs/ko/cli/list.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: 콘텐츠 선언 파일 목록
+description: 프로젝트 내 모든 콘텐츠 선언 파일을 나열하는 방법을 알아보세요.
+keywords:
+  - 목록
+  - 콘텐츠 선언
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - list
+---
+
+# 콘텐츠 선언 파일 목록
+
+```bash
+npx intlayer content list
+```
+
+## 별칭:
+
+- `npx intlayer list`
+
+이 명령어는 프로젝트 내 모든 콘텐츠 선언 파일을 표시하며, 해당 파일들의 딕셔너리 키와 파일 경로를 보여줍니다. 모든 콘텐츠 파일을 한눈에 파악하고 Intlayer가 제대로 인식하는지 확인하는 데 유용합니다.
+
+## 예시:
+
+```bash
+npx intlayer content list
+```
+
+## 예시 출력:
+
+```bash
+npx intlayer content list
+Content declaration files:
+ - home-page        - src/components/HomePage/homePage.content.ts
+ - server-component - src/components/ServerComponent/serverComponent.content.ts
+ - client-component - src/components/ClientComponent/clientComponent.content.ts
+
+총 콘텐츠 선언 파일 수: 3
+```
+
+이 명령어는 다음을 출력합니다:
+
+- 키와 상대 파일 경로가 포함된 모든 콘텐츠 선언 파일의 형식화된 목록
+- 발견된 콘텐츠 선언 파일의 총 개수
+
+이 출력은 모든 콘텐츠 파일이 올바르게 구성되어 Intlayer 시스템에서 인식 가능한지 확인하는 데 도움이 됩니다.

package/docs/ko/cli/live.md

@@ -0,0 +1,41 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: 라이브 싱크 명령어
+description: 런타임에 CMS 콘텐츠 변경 사항을 반영하기 위해 라이브 싱크를 사용하는 방법을 알아보세요.
+keywords:
+  - 라이브 싱크
+  - CMS
+  - 런타임
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - live
+---
+
+# 라이브 싱크 명령어
+
+라이브 싱크는 앱이 런타임에 CMS 콘텐츠 변경 사항을 반영할 수 있게 합니다. 재빌드나 재배포가 필요 없습니다. 활성화되면 업데이트가 라이브 싱크 서버로 스트리밍되어 애플리케이션이 읽는 사전을 갱신합니다. 자세한 내용은 [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)를 참조하세요.
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:live:start": "npx intlayer live start --with 'next dev --turbopack'"
+}
+```
+
+## 인자:
+
+**설정 옵션:**
+
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다. intlayer 구성을 가져오기 위해 명령어는 기본 디렉토리에서 `intlayer.config.{ts,js,json,cjs,mjs}` 파일을 찾습니다.
+
+- **`--no-cache`**: 캐시를 비활성화합니다.
+
+  > 예시: `npx intlayer dictionary push --env-file .env.production.local`
+
+**로그 옵션:**
+
+- **`--verbose`**: 디버깅을 위해 상세 로그를 활성화합니다. (CLI에서 기본값은 true)

package/docs/ko/cli/pull.md

@@ -0,0 +1,78 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: 사전 가져오기
+description: Intlayer 에디터와 CMS에서 사전을 가져오는 방법을 알아보세요.
+keywords:
+  - 가져오기
+  - 사전
+  - CLI
+  - Intlayer
+  - 에디터
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - pull
+---
+
+# 원격 사전 가져오기
+
+```bash
+npx intlayer pull
+```
+
+[intlayer 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)가 설치되어 있으면, 에디터에서 사전을 가져올 수도 있습니다. 이렇게 하면 애플리케이션의 필요에 따라 사전 내용을 덮어쓸 수 있습니다.
+
+## 별칭:
+
+- `npx intlayer dictionaries pull`
+- `npx intlayer dictionary pull`
+- `npx intlayer dic pull`
+
+## 인수:
+
+**사전 옵션:**
+
+- **`-d, --dictionaries`**: 가져올 사전의 ID입니다. 지정하지 않으면 모든 사전이 가져와집니다.
+
+  > 예시: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: 가져올 사전의 ID입니다 (--dictionaries의 별칭).
+
+  > 예시: `npx intlayer dictionary pull --dictionary my-dictionary-id my-other-dictionary-id`
+
+**구성 옵션:**
+
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다. intlayer 구성을 가져오기 위해 명령어는 기본 디렉토리에서 `intlayer.config.{ts,js,json,cjs,mjs}` 파일을 찾습니다.
+
+  > 예시: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: 캐시를 비활성화합니다.
+
+  > 예시: `npx intlayer build --no-cache`
+
+**환경 변수 옵션:**
+
+- **`--env`**: 환경을 지정합니다 (예: `development`, `production`).
+- **`--env-file`**: 변수를 로드할 사용자 정의 환경 파일을 제공합니다.
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다. intlayer 구성을 가져오기 위해 명령어는 기본 디렉토리에서 `intlayer.config.{ts,js,json,cjs,mjs}` 파일을 찾습니다.
+
+  > 예시: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > 예시: `npx intlayer dictionary push --env production`
+
+**출력 옵션:**
+
+- **`--new-dictionaries-path`** : 새 사전이 저장될 디렉토리 경로입니다. 지정하지 않으면 새 사전은 프로젝트의 `./intlayer-dictionaries` 디렉토리에 저장됩니다. 사전 내용에 `filePath` 필드가 지정된 경우, 사전은 이 인수를 무시하고 지정된 `filePath` 디렉토리에 저장됩니다.
+
+**로그 옵션:**
+
+- **`--verbose`**: 디버깅을 위한 상세 로그를 활성화합니다. (CLI에서 기본값은 true입니다)
+
+## 예시:
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```

package/docs/ko/cli/push.md

@@ -0,0 +1,113 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: 사전 푸시하기
+description: Intlayer 에디터와 CMS에 사전을 푸시하는 방법을 알아보세요.
+keywords:
+  - 푸시
+  - 사전
+  - CLI
+  - Intlayer
+  - 에디터
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - push
+---
+
+# 사전 푸시하기
+
+```bash
+npx intlayer dictionary push
+```
+
+[intlayer 에디터](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_visual_editor.md)가 설치되어 있다면, 사전을 에디터로도 푸시할 수 있습니다. 이 명령어는 사전을 [에디터](https://intlayer.org/dashboard)에서 사용할 수 있도록 합니다. 이를 통해 팀과 사전을 공유하고 애플리케이션 코드를 수정하지 않고도 콘텐츠를 편집할 수 있습니다.
+
+## 별칭:
+
+- `npx intlayer dictionaries push`
+- `npx intlayer dictionary push`
+- `npx intlayer dic push`
+
+## 인수:
+
+**사전 옵션:**
+
+- **`-d`, `--dictionaries`**: 가져올 사전의 ID들입니다. 지정하지 않으면 모든 사전이 푸시됩니다.
+
+  > 예시: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: 가져올 사전의 ID들 (--dictionaries의 별칭).
+
+  > 예시: `npx intlayer dictionary push --dictionary my-dictionary-id my-other-dictionary-id`
+
+**설정 옵션:**
+
+- **`--base-dir`**: 프로젝트의 기본 디렉토리를 지정합니다. intlayer 설정을 가져오기 위해, 이 명령어는 기본 디렉토리에서 `intlayer.config.{ts,js,json,cjs,mjs}` 파일을 찾습니다.
+
+  > 예시: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: 캐시를 비활성화합니다.
+
+  > 예시: `npx intlayer build --no-cache`
+
+**환경 변수 옵션:**
+
+- **`--env`**: 환경을 지정합니다 (예: `development`, `production`). intlayer 설정 파일에서 환경 변수를 사용하는 경우에 유용합니다.
+- **`--env-file`**: 변수를 로드할 사용자 지정 환경 파일을 제공합니다. intlayer 설정 파일에서 환경 변수를 사용하는 경우에 유용합니다.
+
+  > 예시: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > 예시: `npx intlayer dictionary push --env production`
+
+**출력 옵션:**
+
+- **`-r`, `--delete-locale-dictionary`**: 사전이 푸시된 후 로케일 디렉토리를 삭제할지 묻는 질문을 건너뛰고 해당 디렉토리를 삭제합니다. 기본적으로 사전이 로컬에 정의되어 있으면 원격 사전 내용을 덮어씁니다.
+
+  > 예시: `npx intlayer dictionary push -r`
+
+  > 예시: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`, `--keep-locale-dictionary`**: 사전이 푸시된 후 로케일 디렉토리를 삭제할지 묻는 질문을 건너뛰고 해당 디렉토리를 유지합니다. 기본적으로 사전이 로컬에 정의되어 있으면 원격 사전 내용을 덮어씁니다.
+
+  > 예시: `npx intlayer dictionary push -k`
+
+  > 예시: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**준비 옵션:**
+
+- **`--build`**: 푸시하기 전에 사전을 빌드하여 내용이 최신 상태인지 확인합니다. true는 빌드를 강제로 수행하고, false는 빌드를 건너뛰며, undefined는 빌드 캐시를 사용하도록 허용합니다.
+
+**로그 옵션:**
+
+- **`--verbose`**: 디버깅을 위해 자세한 로깅을 활성화합니다. (CLI 기본값은 true)
+
+**Git 옵션:**
+
+- **`--git-diff`**: 기본 브랜치(기본값 `origin/main`)에서 현재 브랜치(기본값 `HEAD`)로 변경된 사전에 대해서만 실행합니다.
+- **`--git-diff-base`**: git diff의 기준 참조를 지정합니다 (기본값 `origin/main`).
+- **`--git-diff-current`**: git diff의 현재 참조를 지정합니다 (기본값 `HEAD`).
+- **`--uncommitted`**: 커밋되지 않은 변경 사항을 포함합니다.
+- **`--unpushed`**: 푸시되지 않은 변경 사항을 포함합니다.
+- **`--untracked`**: 추적되지 않은 파일을 포함합니다.
+
+- **`--build`**: 푸시 전에 사전을 빌드하여 콘텐츠가 최신 상태인지 확인합니다. true는 빌드를 강제 실행하고, false는 빌드를 건너뛰며, undefined는 빌드 캐시를 사용하도록 허용합니다.
+
+**로그 옵션:**
+
+- **`--verbose`**: 디버깅을 위한 자세한 로깅을 활성화합니다. (기본값은 CLI에서 true)
+
+**Git 옵션:**
+
+- **`--git-diff`**: 기본 브랜치(기본값: `origin/main`)와 현재 브랜치(기본값: `HEAD`) 간의 변경 사항이 포함된 사전에만 실행합니다.
+- **`--git-diff-base`**: git diff의 기준 참조를 지정합니다. (기본값: `origin/main`)
+- **`--git-diff-current`**: git diff의 현재 참조를 지정합니다. (기본값: `HEAD`)
+- **`--uncommitted`**: 커밋되지 않은 변경 사항을 포함합니다.
+- **`--unpushed`**: 푸시되지 않은 변경 사항을 포함합니다.
+- **`--untracked`**: 추적되지 않은 파일을 포함합니다.
+
+  > 예시: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > 예시: `npx intlayer dictionary push --uncommitted --unpushed --untracked`

package/docs/ko/cli/sdk.md

@@ -0,0 +1,67 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: CLI SDK
+description: Intlayer CLI SDK를 자신의 코드에서 사용하는 방법을 알아보세요.
+keywords:
+  - SDK
+  - CLI
+  - Intlayer
+  - 프로그래밍 방식
+slugs:
+  - doc
+  - concept
+  - cli
+  - sdk
+---
+
+# CLI SDK
+
+CLI SDK는 Intlayer CLI를 자신의 코드에서 사용할 수 있게 해주는 라이브러리입니다.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+사용 예시:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  listContentDeclaration,
+  testMissingTranslations,
+  docTranslate,
+  docReview,
+  transform,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+listContentDeclaration();
+// ...
+testMissingTranslations();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+transform();
+// ...
+```