기타 명령어 · Lingo.dev

설정 및 사용자 확인 관련 명령어입니다. 소스 콘텐츠는 전혀 건드리지 않고, 자격 증명과 프로젝트 연결만 관리합니다.

Lingo.dev에 인증합니다. 방식은 두 가지입니다:

브라우저(기본값, 대화형)#

bash

lingo login

브라우저에서 Lingo.dev 화면이 열리면 CLI 사용을 승인하세요. 아직 로그인하지 않았다면 먼저 로그인하세요. CLI 세션은 ~/.lingo/credentials.json에 저장되며, lingo logout 명령을 실행할 때까지 최신 상태로 유지됩니다.

아직 조직에 속해 있지 않거나 웹 앱에서 조직을 만들었지만 설정을 끝내지 않았다면, 이어서 login 명령이 웹 앱에서 설정을 마칠 수 있는 링크를 출력합니다:

text

Finish setting up Acme Inc in the web app: https://lingo.dev/orgs/org_a8c...

웹 앱에서 설정을 진행하면 웹사이트를 기반으로 조직의 첫 번째 엔진을 만듭니다.

`lingo logout`#

bash

lingo logout

~/.lingo/credentials.json를 삭제합니다. 로그인 상태가 아니었다면 아무 일도 일어나지 않습니다.

`lingo link`#

bash

lingo link
lingo link --org org_a8c... --engine eng_b9d...   # skip prompts

현재 프로젝트를 조직과 로컬라이제이션 엔진에 연결합니다. orgId + engineId를 .lingo/config.json에 기록합니다(커밋하세요).

대화형 모드에서는 기존 조직과 엔진을 선택하거나 그 자리에서 새로 만들 수 있습니다. link은 이름 입력을 요청하고, 새 조직을 만드는 경우 온보딩 설문을 진행한 뒤 API로 조직을 생성하고 연결합니다.

직접 만든 조직의 설정을 웹 앱에서 아직 진행 중이라면, link은 해당 조직에 엔진을 만들지 않습니다. 대신 설정을 완료할 수 있는 링크와 조직의 기존 엔진 목록을 보여줍니다. 기존 엔진이 없으면 해당 링크를 표시하고 종료합니다. 설정을 완료한 뒤 lingo link을 다시 실행하세요. 초대받은 조직과 API 키로 실행되는 조직에는 영향을 주지 않습니다.

아직 조직에 속해 있지 않거나 조직에서 요구하는 통합 인증으로 로그인하지 않았다면, link 명령은 대신 웹 앱 링크를 출력하고 종료됩니다. 웹 앱에서 조직을 설정하거나 통합 인증으로 로그인한 다음 lingo link 명령을 다시 실행하세요.

`lingo unlink`#

bash

lingo unlink

orgId에서 engineId와 .lingo/config.json를 제거합니다. 조직이나 엔진 자체를 삭제하는 것은 아니고, 로컬 연결만 끊습니다. 다른 엔진에 다시 연결하기 전에 유용합니다.

`lingo whoami`#

bash

lingo whoami
lingo whoami --json

다음 세 가지를 보여줍니다:

Identity — 현재 로그인한 이메일, 또는 API 키를 사용 중인지 여부.
Org — 연결된 조직(API에서 이름 조회).
Engine — 연결된 엔진(API에서 이름 조회).

text

Email:   you@company.com
  Org:     Acme Inc (org_a8c...)
  Engine:  Production (eng_b9d...)
  Auth:    session

연결된 프로젝트 디렉터리가 아니면 Org/Engine 항목은 표시되지 않습니다. --json는 같은 데이터를 스크립트에서 쓰기 좋은 구조화된 형태로 출력합니다.

전역 `--api-key` 플래그#

모든 명령어는 해당 실행에 한해 저장된 자격 증명을 덮어쓰는 --api-key 플래그를 지원합니다. CI에서의 일반적인 패턴은 다음과 같습니다:

yaml

env:
  LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}
steps:
  - run: lingo push --backfill-missing --yes --wait --api-key "$LINGO_API_KEY"

(CLI는 대체 수단으로 환경 변수의 LINGO_API_KEY도 읽습니다.)

다음으로#

lingo push — 범위 지정 + 델타 번역.
lingo pull — 마지막 푸시의 출력을 가져오고 충돌도 감지합니다.
Configuration — .lingo/config.json, lockfile, 실행 상태.