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         도움말 표시