CLI 명령어
Lingo.dev CLI 명령어에 대한 참조 문서
이 페이지는 Lingo.dev CLI를 통해 사용 가능한 모든 명령어의 전체 목록을 포함하고 있습니다. CLI 자체에서 이 문서에 접근하려면 다음 명령어를 실행하세요:
npx lingo.dev@latest --help
lingo.dev
사용법: lingo.dev [options] [command]
Lingo.dev CLI
옵션:
-v, --version 버전 표시
-y, --no-interactive 대화형 모드 비활성화
-h, --help 도움말 표시
명령어:
init [options] Lingo.dev 프로젝트 초기화
i18n [options] 로컬라이제이션 엔진 실행
auth [options] 현재 인증 상태 표시
login Lingo.dev API로 인증
logout Lingo.dev API에서 로그아웃
show 현재 구성 출력
config Lingo.dev CLI 구성 관리
lockfile [options] 락파일이 존재하지 않는 경우 생성
cleanup [options] 소스 파일에 존재하지 않는 키를 대상 파일에서 제거
mcp AI 에이전트와 함께 Lingo.dev 모델 컨텍스트 제공자 사용
ci [options] Lingo.dev CI/CD 액션 실행
status [options] 로컬라이제이션 프로세스의 상태 표시
run [options] Lingo.dev 로컬라이제이션 엔진 실행
purge [options] 지정된 --bucket, --file, --key, --locale에 대한 번역 제거
help [command] 명령어에 대한 도움말 표시
lingo.dev init
사용법: lingo.dev init [options]
Lingo.dev 프로젝트 초기화
옵션:
-f --force 기존 구성 덮어쓰기 (기본값: false)
-s --source <locale> 소스 로케일 (기본값: "en")
-t --targets <locale...> 대상 로케일 목록 (기본값: "es")
-b, --bucket <type> 버킷 유형 (기본값: "json")
-p, --paths [path...] 버킷의 경로 목록 (기본값: [])
-y, --no-interactive 대화형 모드 비활성화
-h, --help 도움말 표시
lingo.dev i18n
사용법: lingo.dev i18n [options]
로컬라이제이션 엔진 실행
옵션:
--locale <locale> 처리할 로케일
--bucket <bucket> 처리할 버킷
--key <key> 처리할 키. 특정 번역 키만 처리, 디버깅이나 단일 항목 업데이트에 유용
--file [files...] 처리할 파일. 특정 경로만 처리, 여러 파일을 매칭하기 위해 별표 *를 포함할 수 있음.
많은 파일이 있고 특정 파일에 집중하고 싶을 때 유용. 쉼표나 공백으로 구분된 여러 파일 지정 가능.
--frozen 읽기 전용 모드로 실행 - 업데이트가 필요한 번역이 있으면 실패, CI/CD 파이프라인에서
누락된 번역을 감지하는 데 유용
--force 락파일을 무시하고 모든 키를 처리, 전체 재번역에 유용
--verbose 중간 처리 데이터 및 API 통신 세부 정보를 포함한 상세 출력 표시
--interactive 적용 전 번역 검토 및 편집을 위한 대화형 모드 활성화
--api-key <api-key> 사용할 API 키를 명시적으로 설정, 설정의 기본 API 키 재정의
--debug 디버깅 목적으로 시작 시 실행 일시 중지, 진행하기 전에 사용자 확인 대기
--strict 다른 로케일/버킷으로 계속 진행하는 대신 첫 번째 오류에서 처리 중지
-h, --help 도움말 표시
lingo.dev auth
Usage: lingo.dev auth [options]
현재 인증 상태 표시
Options:
--login 계정에 로그인 (사용 중단됨: 대신 'lingo.dev login' 사용)
--logout 계정에서 로그아웃 (사용 중단됨: 대신 'lingo.dev logout' 사용)
-h, --help 도움말 표시
lingo.dev login
Usage: lingo.dev login [options]
Lingo.dev API로 인증
Options:
-h, --help 도움말 표시
lingo.dev logout
Usage: lingo.dev logout [options]
Lingo.dev API에서 로그아웃
Options:
-h, --help 도움말 표시
lingo.dev show
Usage: lingo.dev show [options] [command]
현재 구성 출력
Options:
-h, --help 도움말 표시
Commands:
config 현재 구성 출력
locale <type> 로케일 목록 출력
files [options] Lingo.dev에서 관리하는 파일 목록 출력
help [command] 명령어에 대한 도움말 표시
lingo.dev show config
Usage: lingo.dev show config [options]
현재 구성 출력
Options:
-h, --help 도움말 표시
lingo.dev show locale
Usage: lingo.dev show locale [options] <type>
로케일 목록 출력
Arguments:
type 표시할 로케일 유형, "sources" 또는 "targets"
Options:
-h, --help 도움말 표시
lingo.dev show files
Usage: lingo.dev show files [options]
Lingo.dev에서 관리하는 파일 목록 출력
Options:
--source 원본 번역이 포함된 소스 파일만 표시
--target 번역된 콘텐츠가 포함된 대상 파일만 표시
-h, --help 도움말 표시
lingo.dev config
Usage: lingo.dev config [options] [command]
Lingo.dev CLI 구성 관리
Options:
-h, --help 도움말 표시
Commands:
set <key> <value> 구성 키를 값으로 설정
unset <key> 구성 키 제거
get <key> 구성 키의 값 가져오기
help [command] 명령어에 대한 도움말 표시
lingo.dev config set
Usage: lingo.dev config set [options] <key> <value>
설정 키에 값을 지정합니다
Arguments:
key 설정할 구성 키
value 새 값
Options:
-h, --help 도움말 표시
lingo.dev config unset
Usage: lingo.dev config unset [options] <key>
구성 키를 제거합니다
Arguments:
key 제거할 구성 키
Options:
-h, --help 도움말 표시
lingo.dev config get
Usage: lingo.dev config get [options] <key>
구성 키의 값을 가져옵니다
Arguments:
key 구성 키
Options:
-h, --help 도움말 표시
lingo.dev lockfile
Usage: lingo.dev lockfile [options]
락파일이 존재하지 않는 경우 생성합니다
Options:
-f, --force 락파일 강제 생성
-h, --help 도움말 표시
lingo.dev cleanup
Usage: lingo.dev cleanup [options]
소스 파일에 존재하지 않는 키를 대상 파일에서 제거합니다
Options:
--locale <locale> 정리할 특정 로케일
--bucket <bucket> 정리할 특정 버킷
--dry-run 변경 없이 제거될 항목 표시
--verbose 다음을 포함한 상세 출력 표시:
- 제거될 키 목록.
- 처리 단계.
-h, --help 도움말 표시
lingo.dev mcp
Usage: lingo.dev mcp [options]
AI 에이전트와 함께 Lingo.dev 모델 컨텍스트 제공자 사용
Options:
-h, --help 도움말 표시
lingo.dev ci
Usage: lingo.dev ci [options]
Lingo.dev CI/CD 액션 실행
Options:
--parallel [boolean] 병렬 모드로 실행
--api-key <key> API 키
--pull-request [boolean] 변경 사항으로 풀 리퀘스트 생성
--commit-message <message> 커밋 메시지
--pull-request-title <title> 풀 리퀘스트 제목
--working-directory <dir> 작업 디렉토리
--process-own-commits [boolean] 이 액션에 의해 생성된 커밋 처리
-h, --help 도움말 표시
lingo.dev status
Usage: lingo.dev status [options]
로컬라이제이션 프로세스의 상태 표시
Options:
--locale <locale> 처리할 로케일
--bucket <bucket> 처리할 버킷
--file [files...] 처리할 파일. 경로에 이 문자열이 포함된 파일만 처리합니다.
파일이 많고 특정 파일에 집중하고 싶을 때 유용합니다.
쉼표나 공백으로 구분하여 여러 파일을 지정할 수 있습니다.
--force 잠금 파일을 무시하고 모든 키를 처리합니다. 전체 재번역 추정에 유용합니다.
--verbose 키 수준의 단어 수를 포함한 상세 출력 표시
--api-key <api-key> API 키를 명시적으로 설정하여 설정의 기본 API 키를 재정의합니다.
-h, --help 도움말 표시
lingo.dev may-the-fourth
Usage: lingo.dev may-the-fourth [options]
포스가 함께하기를
Options:
-h, --help 도움말 표시
lingo.dev run
Usage: lingo.dev run [options]
Lingo.dev 로컬라이제이션 엔진 실행
Options:
--source-locale <source-locale> 소스 로케일로 사용할 로케일. 기본값은 i18n.json의 locale.source입니다.
--target-locale <target-locale> 대상 로케일로 사용할 로케일. 기본값은 i18n.json의 locale.targets입니다.
--bucket <bucket> 처리할 버킷
--file <file> 처리할 파일. 경로에서 이 글로브 패턴과 일치하는 파일만 처리합니다.
셸 확장을 방지하기 위해 패턴 주위에 따옴표를 사용하세요(예: --file '**/*.json').
파일이 많고 특정 파일에 집중하고 싶을 때 유용합니다.
쉼표나 공백으로 구분하여 여러 파일을 지정할 수 있습니다.
글로브 패턴을 허용합니다.
--key <key> 처리할 키. 특정 번역 키만 처리합니다. 단일 항목 업데이트에 유용합니다.
글로브 패턴을 허용합니다.
--force 잠금 파일을 무시하고 모든 키를 처리합니다. 전체 재번역에 유용합니다.
--api-key <api-key> API 키를 명시적으로 설정하여 설정의 기본 API 키를 재정의합니다.
--debug 디버깅 목적으로 시작 시 실행을 일시 중지하고, 진행하기 전에 사용자 확인을 기다립니다.
--concurrency <concurrency> 실행할 동시 작업 수
--watch 소스 파일의 변경 사항을 감시하고 자동으로 재번역합니다.
--debounce <milliseconds> 감시 모드의 디바운스 지연 시간(밀리초)(기본값: 5000ms)
-h, --help 도움말 표시
lingo.dev purge
Usage: lingo.dev purge [options]
지정된 --bucket, --file, --key, --locale에 대한 번역 제거
Options:
--bucket <bucket> 처리할 버킷
--file [files...] 처리할 파일. 지정된 글로브 패턴과 일치하는 파일만 처리합니다.
--key <key> 제거할 키. 지정된 글로브 패턴과 일치하는 모든 번역 키를 제거합니다.
--locale <locale> 처리할 로케일
--yes-really 대화형 확인을 건너뛰고 묻지 않고 삭제합니다.
-h, --help 도움말 표시