その他のコマンド

Max PrilutskiyCEO 兼 共同創業者更新日:2 か月前 · 読了目安 1分

セットアップと認証まわりのコマンドです。いずれもソースコンテンツには触れず、認証情報とプロジェクトの紐付けだけを管理します。

lingo login#

Lingo.dev にログインします。方法は 2 つあります。

OTP(デフォルト / 対話式)#

bash
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 / 非対話式)#

bash
lingo login --api-key lk_...

API キーを保存します。キーは Lingo.dev プラットフォームの組織設定にある API keys から生成できます。

また、どのコマンドでも --api-keyグローバルフラグとして渡せます。その場合、保存済みの認証情報は一切使われません。

bash
lingo push --api-key lk_...

認証情報をディスクに書き込みたくない単発の CI ジョブに便利です。

lingo logout#

bash
lingo logout

~/.lingo/auth.json を削除します。ログインしていない場合は何も起こりません。

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

現在のプロジェクトを組織とローカライゼーションエンジンに紐付けます。orgIdengineId.lingo/config.json に書き込みます(コミットしてください)。

対話モードでは、既存の組織やエンジンから選ぶことも、その場で新しく作成することもできます。link は名前の入力を促し、新しい組織にはオンボーディングアンケートを実施したうえで、リンク前に API 経由でリソースを作成します。

bash
lingo unlink

orgIdengineId.lingo/config.json から削除します。組織やエンジン自体は削除されず、ローカルの紐付けだけが解除されます。別のエンジンに再リンクする前に便利です。

lingo whoami#

bash
lingo whoami
lingo whoami --json

次の 3 つを表示します。

  1. Identity — ログイン中のメールアドレス、または API キーを使っているかどうか。
  2. Org — リンク中の組織(名前は API から解決されます)。
  3. 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 --api-key "$LINGO_API_KEY"

(CLI はフォールバックとして、環境変数から LINGO_API_KEY を読み取ることもできます。)

次に読むもの#