プラットフォームアカウントを作成

その他のコマンド

Max PrilutskiyCEO 兼 共同創業者読了目安 1分

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

lingo login#

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

ブラウザ（既定、対話モード）#

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...

ウェブアプリでの設定では、ウェブサイトをもとに、その組織で最初のエンジンを作成します。

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/credentials.json を削除します。ログインしていない場合は何も起こりません。

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

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

対話モードでは、既存の組織やエンジンを選ぶことも、その場で新しく作成することもできます。linkが名前の入力を求め、新しい組織を作成する場合は初期設定のアンケートを表示します。その後、API経由で作成してから関連付けます。

自分で作成した組織の設定がウェブアプリで完了するまでは、linkはその組織にエンジンを作成しません。設定を完了するためのリンクと、その組織の既存のエンジン一覧を表示します。エンジンがない場合は、リンクを表示して終了します。設定を完了してから、lingo linkをもう一度実行してください。招待された組織でAPIキーを使って実行する場合は、この制限の影響を受けません。

bash
lingo unlink

orgId と engineId を .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 --wait --api-key "$LINGO_API_KEY"

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

次に読むもの#

  • lingo push — スコープ指定 + 差分翻訳。
  • lingo pull — 最後にプッシュした出力を取得し、競合を検出します。
  • Configuration — .lingo/config.json、lockfile、実行状態。