lizard

Lizard - ブートストラップ

これは簡易的なエントリーポイントです。正規のガイドは lizard CLI 内にあり、CLI とともにバージョン管理されるため、インストール済みの CLI バージョンと常に一致します。

前向きに考えてください： CLI はすでに利用可能だと想定します。まずコアガイドの読み込みを試し、コマンドが実際に失敗した場合にのみ、インストール方法や権限に関するヘルプに切り替えてください。

このファイルをもとに lizard のコマンドを推測してはいけません。完全な手順、フラグ、終了コードは、読み込んだコアガイドに記載されています。

CLI を npx（npx @lizard-build/cli、npx lizard など）経由で実行してはいけません。 必ずグローバルにインストールされた lizard バイナリを使用してください。npx は使い捨てのコピーをキャッシュに取得します。そのバージョンは読み込んだガイドと一致しない場合があり、以下のインストール手順も回避されます。lizard が PATH 上にない場合は、インストールしてください（手順 2a）。動作確認だけの場合でも、npx は使用しないでください。

手順 1 - コアガイドを読み込む（最初に試す）

すぐに実行してください：

lizard upgrade --check --json
lizard skills get core --json

ガイドは CLI に同梱されているため、古い CLI では古いコマンドが案内されます（サンドボックスのテンプレートや古いマシンには、古いバージョンが含まれていることがよくあります）。確認結果が updateAvailable: true の場合は、lizard upgrade --json を実行してから、ガイドをもう一度読み込んでください。upgraded: false と hint が返された場合は、ヒントを実行してください（例：npm install -g @lizard-build/cli@latest）。確認に失敗しても（オフラインやレート制限など）、作業を中止する理由にはなりません。手元にあるガイドを使用してください。

lizard skills get core --json は { name, frontmatter, content, references, ... } を返します。content をすべて読み込んでください。これは、サンドボックス、デプロイ、アドオン、サインイン、終了コード、課金を含む、プラットフォーム全体に関する最新の Lizard ガイドです。以降の作業では、このガイドに従ってください。

references には、より詳細な 3 つのガイド（sandboxes、deploys、コードから Lizard を利用するための sdk）が記載されています。より詳しい情報が必要な場合にのみ、読み込んでください。

lizard skills get core --ref sdk --json

CLI が --ref を受け付けない場合（4.0.45 より前のバージョン）は、その指定を省略してください。それらのバージョンでは、content にすでにすべての情報が含まれています。

ガイドを読み込めた場合は、手順 2 の復旧処理を省略して、手順 4 に進んで作業してください。ユーザーはすでにログイン済みだと想定します。command -v lizard を実行したり、先回りしてログインしたり、上記のアップグレード以外のものをインストールしたりしないでください。認証がないとコマンドから実際に報告された場合にのみ、手順 3 に進んでください。

手順 2 - 失敗した場合にのみ復旧する

手順 1 での失敗には、以下の順に対処してください。いずれかの方法が成功したら、すぐにそこで終了してガイドに戻ってください。

2a. lizard: command not found（CLI が PATH 上にない）

macOS または Linux では、インストールスクリプトを使ってインストールし、手順 1 を再試行してください：

curl -fsSL https://lizard.build/install.sh | bash

Node.js も sudo も不要で、バイナリは自動で更新されます。また、すでに PATH に含まれているディレクトリへ lizard をリンクするため、このセッションですぐに CLI を使用できます。スクリプトの最後の行に lizard が見つからない可能性があると表示された場合は、このセッション中は ~/.lizard/bin/lizard として呼び出してください。PATH 上で別の lizard が先に見つかると表示された場合は、通常は古い npm インストールが原因であり、npm uninstall -g @lizard-build/cli で削除できることをユーザーに伝えてください。

スクリプトの最後にサインイン処理が実行されます。まだマシンでサインインしていない場合、最後の行には status: "pending" とサインイン用リンクを含む JSON オブジェクトが表示されます。手順 3 の説明に従って、ユーザーにリンクを渡してください。

Windows の場合、またはスクリプトを実行できない場合（curl がない、システムがサポート対象外、ダウンロードに失敗したなど）は、代わりに npm からインストールしてください：

npm install -g @lizard-build/cli

2b. 権限エラーでインストールに失敗する

sudo を使って再試行してはいけません。macOS または Linux では、2a のインストールスクリプトを使用してください。ユーザーのホームディレクトリにインストールされるため、管理者権限は不要です。

npm が EACCES で失敗した場合は、ユーザー自身のターミナルでインストールを実行するよう依頼してください（Claude Code や Cursor など、セッション内のシェルパススルーに対応するエージェントでは、! npm install -g @lizard-build/cli と入力できます）。再度失敗した場合は、グローバルバイナリがユーザーの書き込み可能なディレクトリに配置されるよう、Node バージョンマネージャー（fnm、nvm、mise）の使用を提案してください。

インストールが完了したことを確認できたら、lizard skills get core --json を再試行してください。

2c. コアガイドを利用できない場合（古い CLI、オフライン、または skills コマンドがない場合）

何かを実行する前に、実行時の検出に切り替えてください。

lizard --help --json
lizard <cmd> --help --json

CLI が古すぎる場合は、lizard upgrade による更新を提案してください。

Step 3 - サインイン（必要な場合のみ）

先回りしてサインインしないでください。ユーザーはすでにサインイン済みだと想定してください。 lizard login が必要になることはほとんどありません。サインインリンクは自動的に表示されます。

• インストールスクリプトの最後の行（Step 2a）。まだサインインできなかった場合に表示されます。
• 終了コード 2 で失敗したコマンドの JSON エラー内の error.body.login。

どちらも同じ形式です。status: "pending"、サインイン方法（github、google）ごとのリンクを含む authUrls、および instruction が含まれます。処理は待機せず、ブラウザーも開きません。ユーザーに Lizard へのサインイン方法を尋ね、該当するリンクをクリック可能な URL として提示してください。すでにアカウントを持っているユーザーは、以前と同じ方法を使う必要があります。別の方法を使うと、両方の方法で確認済みのメールアドレスが共有されていない限り、別の空のアカウントが作成されます。新規ユーザーはどちらを選んでもかまいません。

ブラウザーに「CLI authorized」と表示されたとユーザーが伝えたら、失敗したコマンドを再実行してください。インストール後であれば、そのまま続けてください。次の lizard コマンドでサインインが完了します。それでも pending と表示される場合は、まだ完了していません。待ってから再試行してください。リンクの有効期限は 5 分で、次回の実行時に新しいリンクが表示されます。

リンクのない終了コード 2 のエラーは、CI または到達できなかったプラットフォームが原因です。その場合は後で再試行するか、同じオブジェクトを出力する lizard login --json を実行してください。CI 内やサーバー上では、リンクを開ける人がいません。API トークンを求めて LIZARD_TOKEN を設定するか、printf '%s' "$TOKEN" | lizard login --token-stdin を使って保存してください。ユーザー自身のターミナルでは、! lizard login を実行すると GitHub または Google による認証が求められ、ブラウザーが開きます。

Step 4 - 実行

$ARGUMENTS が空でない場合は、それをユーザーのリクエストとして扱い、ステップ 1 のガイド（またはステップ 2 の復旧手順）に沿って実行してください。空の場合は、Lizard で何をしたいかユーザーに尋ねてください。