セットアップと認証まわりのコマンドです。いずれもソースコンテンツには触れず、認証情報とプロジェクトの紐付けだけを管理します。
lingo login#
Lingo.dev にログインします。方法は 2 つあります。
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 unlinkorgId と engineId を .lingo/config.json から削除します。組織やエンジン自体は削除されず、ローカルの紐付けだけが解除されます。別のエンジンに再リンクする前に便利です。
lingo whoami#
lingo whoami
lingo whoami --json次の 3 つを表示します。
- 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、実行状態。
