CLI 명령어 레퍼런스

설정, 번역, 카탈로그 관리에 필요한 CLI 명령어를 찾아보세요.

기본적인 명령어를 찾아보려면 lingo --help를, 옵션을 확인하려면 lingo <command> --help를 사용하세요. lingo --version로 설치된 세대를 확인할 수 있습니다. 현재 패키지는 @lingo.dev/cli이며, i18n.json 프로젝트는 별도의 버전 0 매뉴얼을 사용합니다.

기존 i18n.json 프로젝트에서는 마이그레이션을 참고해 이전 워크플로에 대응하는 현재 명령어를 확인하세요.

초기화 #

lingo init은 원본 및 대상 로캘과 파일 패턴의 기본 구성을 생성합니다. 강제 옵션을 사용하면 기존 파일 항목이 대체되고 고급 옵션이 삭제될 수 있으므로, 번역 전에 생성된 구성을 확인하세요.

로그인 #

lingo login은 브라우저 세션이나 검증된 API 키를 저장합니다. 이 명령어의 로컬 --api-key는 키를 영구 저장합니다. 다른 명령어에서 사용하는 전역 옵션은 해당 실행에만 적용됩니다.

로그아웃 #

lingo logout은 영구 저장된 인증 정보를 삭제합니다. 환경 변수나 실행 시 지정한 키는 계속 유효합니다.

내 정보 확인 #

lingo whoami는 사용자 정보와 인증 유형을 표시하며, --json는 기계가 읽을 수 있는 형식으로 출력합니다. 연결 문제로 저장된 정보를 대신 표시하는 경우, 온라인 검증이 이루어진 것은 아닙니다.

lingo link는 파일 번역에 사용할 조직 및 로컬라이제이션 엔진 식별자를 저장합니다. 식별자는 리소스를 선택할 뿐, 접근 권한을 부여하지 않습니다.

lingo unlink는 해당 식별자를 제거하며, 파일과 로컬라이제이션 설정, 원격 리소스는 그대로 유지합니다.

업로드 #

lingo push는 원본 파일을 제출합니다. 모드별로 기준본 저장, 증분 번역, 누락된 대상 채우기, 키 갱신, 강제 대체 작업을 구분해 수행합니다. --wait는 결과도 가져옵니다. 다시 실행하면 실패한 작업을 재시도합니다.

다운로드 #

lingo pull은 로컬에 기록된 가장 최근 실행의 결과를 가져오고, 파일에 쓰기 전에 대상 해시를 확인합니다. --dry-run는 파일 쓰기 여부를 미리 보여주지만, 이때도 서버에 접속할 수 있습니다.

제거 #

lingo purge는 파생된 대상을 미리 보여주거나 삭제합니다. 파일 또는 로캘 필터를 지정하면 Lockfile에서 선택한 대상 항목만 제거하고, 필터를 지정하지 않으면 Lockfile 전체를 제거합니다. 공유 XCStrings 카탈로그는 건너뜁니다.

추출 #

lingo extract는 지원되는 정적 타입스크립트 및 TSX 호출을 원본 JSONC와 선언으로 변환합니다. 로컬에서 추출만 수행하며, 코드를 자동으로 수정하거나 번역하지는 않습니다.

검사 #

lingo check는 대상 파일이 없거나, .lingo/lock.json이 있는 상태에서 마지막 번역 이후 원본이 변경되면 실패합니다. 네트워크 호출이 없고 API 키도 필요하지 않습니다. Lockfile이 없으면 대상 파일의 존재 여부만 확인합니다. 리액트 프로젝트에서는 카탈로그와 타입의 최신 상태, 컨텍스트, 고아 항목, 누락된 번역도 확인합니다. 리액트가 아닌 대상의 내부 키는 확인하지 않으며, 번역 품질도 평가하지 않습니다.

정리 #

lingo clean은 JSONC 카탈로그에서 원본의 고아 항목과 오래된 대상 항목을 즉시 제거합니다. 모의 실행 플래그는 제공하지 않으며, 선언을 다시 생성하지도 않습니다.

가이드 #

lingo guide [name]는 패키지에 포함된 오프라인 리액트 가이드를 출력합니다. 이름으로 index, setup-react, api, migrate를 지정할 수 있으며, 생략하면 색인이 선택됩니다. 알 수 없는 이름을 지정하면 사용 가능한 항목을 안내합니다. 가이드의 내용은 설치된 패키지 버전에 해당합니다.

에이전트 가이드 #

lingo agent-guide [name]는 인공지능 에이전트용입니다. 이름을 지정하지 않으면 설정, 로그인, MCP server 관련 안내와 에이전트용 및 사용자용 가이드 목록이 담긴 에이전트 가이드를 출력합니다. 이름을 지정하면 해당 가이드를 출력하며, 목록에 없는 스택별 가이드도 이름으로 지정할 수 있습니다. 가이드 내용은 설치된 패키지 버전에 맞춰 제공됩니다.

에이전트 #

lingo agent setup는 감지된 코딩 에이전트(Claude Code, Codex, Cursor와 현재 자신이 실행되는 에이전트)에 Lingo.dev MCP server가 있는지 확인하고, 없는 에이전트에는 MCP 설정을 안내합니다. 에이전트의 설정 파일은 절대 수정하지 않습니다. --client로 확인할 에이전트를 직접 지정할 수도 있으며, 감지되지 않은 에이전트도 지정할 수 있습니다. 확인할 에이전트가 없으면 아무것도 기록하지 않고 실패합니다. 프로젝트 내에서는 AGENTS.md에 Lingo.dev 블록을 기록하고 기존 CLAUDE.md에도 기록하되, 블록을 담을 AGENTS.md을 가져오는 경우는 제외합니다. CLAUDE.md은 절대 생성하지 않습니다. 파일을 읽을 수 없거나, 파일이 프로젝트 외부로 연결되거나, 블록 표시자의 짝이 맞지 않으면 해당 파일을 그대로 두고 이유를 알려 줍니다. 파일을 수정한 뒤 설정을 다시 실행하세요. --dry-run는 실행 계획을 보여 주고, -y는 확인을 요청하지 않고 기록하며, --status는 --client을 무시하고 감지된 에이전트의 설정 현황을 보여 줍니다. 코딩 에이전트로 설정하기에는 에이전트에 전달할 프롬프트가 있습니다.

업데이트 #

lingo update는 감지된 설치 방식을 사용합니다. 특정 릴리스를 설치하려면 패키지 관리자를 사용하세요. 업데이트 확인 결과는 캐시됩니다. 지속적 통합 환경이 감지되거나 환경 변수로 업데이트 확인을 비활성화하면 확인을 건너뜁니다.

점수 산정 #

lingo score는 등록된 명령어이지만 일반 도움말에는 표시되지 않습니다. 오픈라우터를 통해 로컬 평가기와 모델의 조합을 실행하고 결과를 로컬에 기록하며, 레이더 이력에는 추가하지 않습니다.