설정 및 사용자 확인 관련 명령어입니다. 소스 콘텐츠는 전혀 건드리지 않고, 자격 증명과 프로젝트 연결만 관리합니다.
lingo login#
Lingo.dev에 인증합니다. 방식은 두 가지입니다:
OTP(기본값, 대화형)#
lingo login
lingo login --email you@company.com # skip the email prompt
lingo login --email you@company.com --code 123456 # skip the code prompt too이메일로 일회용 코드를 보내 검증한 뒤, Supabase 세션을 ~/.lingo/auth.json에 저장합니다. 명시적으로 logout할 때까지 세션이 유지되도록 리프레시 토큰도 함께 저장됩니다.
API 키(CI / 비대화형)#
lingo login --api-key lk_...API 키를 저장합니다. 키는 Lingo.dev 플랫폼의 조직 API keys 설정에서 생성할 수 있습니다.
모든 명령어에서 --api-key를 전역 플래그로 넘길 수도 있으며, 이 경우 저장된 자격 증명은 완전히 우회됩니다:
lingo push --api-key lk_...디스크에 자격 증명을 남기면 안 되는 일회성 CI 작업에 유용합니다.
lingo logout#
lingo logout~/.lingo/auth.json를 삭제합니다. 로그인 상태가 아니었다면 아무 일도 일어나지 않습니다.
lingo link#
lingo link
lingo link --org org_a8c... --engine eng_b9d... # skip prompts현재 프로젝트를 조직과 로컬라이제이션 엔진에 연결합니다. orgId + engineId를 .lingo/config.json에 기록합니다(커밋하세요).
대화형 모드에서는 기존 조직/엔진 중에서 고르거나 새로 바로 만들 수 있습니다. link가 이름을 묻고, 새 조직이라면 온보딩 설문을 진행한 뒤, 연결 전에 API를 통해 리소스를 생성합니다.
lingo unlink#
lingo unlink.lingo/config.json에서 orgId와 engineId를 제거합니다. 조직이나 엔진 자체를 삭제하는 것은 아니고, 로컬 연결만 끊습니다. 다른 엔진에 다시 연결하기 전에 유용합니다.
lingo whoami#
lingo whoami
lingo whoami --json다음 세 가지를 보여줍니다:
- Identity — 현재 로그인한 이메일, 또는 API 키를 사용 중인지 여부.
- Org — 연결된 조직(API에서 이름 조회).
- Engine — 연결된 엔진(API에서 이름 조회).
Email: you@company.com
Org: Acme Inc (org_a8c...)
Engine: Production (eng_b9d...)
Auth: session연결된 프로젝트 디렉터리가 아니면 Org/Engine 항목은 표시되지 않습니다. --json는 같은 데이터를 스크립트에서 쓰기 좋은 구조화된 형태로 출력합니다.
전역 --api-key 플래그#
모든 명령어는 해당 실행에 한해 저장된 자격 증명을 덮어쓰는 --api-key 플래그를 지원합니다. CI에서의 일반적인 패턴은 다음과 같습니다:
env:
LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}
steps:
- run: lingo push --backfill-missing --yes --api-key "$LINGO_API_KEY"(CLI는 대체 수단으로 환경 변수의 LINGO_API_KEY도 읽습니다.)
다음으로#
- lingo push — 범위 지정 + 델타 번역.
- lingo pull — 여러 머신에서 가져오기.
- Configuration —
.lingo/config.json, lockfile, 실행 상태.
