コーディングエージェント

コーディングエージェント

Claude Code、Codex、Cursor などの AI コーディングエージェントは、Lizard CLI を通じて Lizard (lizard.build) にアプリをデプロイし、管理します。npx skills add lizard-build/skill -g で Lizard Skill を一度インストールすると、エージェントは lizard skills get core --json で CLI に組み込まれたガイドを読み込み、--help --json で任意のコマンドのフラグを確認します。ChatGPT や Claude など MCP で通信するクライアントは、代わりに Lizard MCP を使えます。エージェントからのデプロイの全手順については、Claude Code、Codex、Cursor からデプロイする を参照してください。

組み込みスキル

CLI には、そのバージョンに対応した利用ガイドを同梱しています。エージェントは次のコマンドで読み取ります:

lizard skills get core --json

これにより { name, frontmatter, content, … } が返されます：content には完全なガイド（ビルドパイプライン、env の優先順位、アドオン、検出、終了コード）が含まれます。関連するサブコマンド:

lizard skills list        # available embedded skills
lizard skills get core    # the core guide
lizard skills path        # where skills are stored

ガイドはバイナリに同梱されているため、lizard upgrade を実行するとエージェントへの指示も更新されます。

自己記述的なコマンド

エージェントは、暗記した構文に頼る代わりに、実行時にフラグの正確な構文を確認します:

lizard --help --json                # full command tree + exit codes
lizard <cmd> --help --json          # a specific command's schema

JSON と自動化 を参照してください。

エージェントでのブートストラップ

典型的なエージェントのフロー:

  1. ガイドを読み込む: lizard skills get core --json → content を読む。
  2. タスクの実行時に認証を確認する: ユーザーのタスクを実行し、終了コード 2 の場合は lizard login を実行し、表示された URL をユーザーに渡してから再試行する。
  3. 求められたらトライアルを開始する: 新しいアカウントにはプランがないため、最初の作成は HTTP 402（code: "PAYMENT_REQUIRED"、終了コード 1）で失敗する。lizard billing start --json を実行し、Checkout の url をユーザーに渡して、カードが追加されたら再試行する。
  4. 変更前に対象を確認する: lizard status (cwd リンク) と lizard ps --json (サービス)。
  5. ガイドに従って実行する：add、up、secrets、domain など。常に --json を付けます。

lizard バイナリが存在しない場合は、最初にインストールしてください。macOS または Linux では、インストールスクリプトを使います:

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

スクリプトは Node.js も sudo も必要とせず、すでに PATH に含まれているフォルダに lizard をリンクするので、エージェントは同じセッション内でそのまま呼び出せます。lizard が見つからない可能性があるとスクリプトに表示された場合は、代わりに ~/.lizard/bin/lizard を呼び出してください。Windows では、PowerShell で次を実行します:

irm https://lizard.build/api/cli/install.ps1 | iex

または、どのシステムでも npm からインストールできます:

npm install -g @lizard-build/cli

エージェントが従うべき慣例

  • 非対話呼び出しでは、常に --json を付ける。
  • サービスの削除、アドオンの削除、プロジェクト全体のシークレットの上書き、本番環境の再起動など、破壊的な操作はユーザーに確認する：CLI 自身のプロンプトは TTY 上でのみ動作します。
  • デフォルトでは シークレットを利用するサービスのスコープに限定する。--global は、公開してよい値だと確認できる場合にのみ使います。変数と Secrets を参照してください。
  • 求められていないのに Dockerfile を書かない：lizardpack はほとんどのスタックを自動検出します。まずはデプロイを試してください。ビルドパイプライン を参照してください。
  • lizard up を使って git 連携サービスをアップロード方式へ切り替えない：service set + redeploy を使います。

エディタ統合

Lizard Skill は、エージェントが利用ガイドを読み込むための初期手順です。エディタやアシスタントにインストールすると、エージェントは必要なときにガイドを読み、このドキュメントで説明する CLI を操作できます。すべてのエージェント向けに一度インストールします:

npx skills add lizard-build/skill -g

Claude Code、Cursor、Codex、Copilot、Gemini CLI のほか、Agent Skills 形式を読み込むエージェントで動作します。シェルコマンドを実行する代わりに MCP で通信するクライアントには、Lizard MCP を使ってください。

これは AI IDE にも当てはまります。アプリの作成やテストは行っても、ホスティングはしません。Google Antigravity で構築したアプリをデプロイする を参照してください。1 つのプロンプトでデプロイ全体を実行します。

Chrome で開いているページを Claude Code や ChatGPT に編集させるには、Lizard Studio を使ってください。

Lizard MCP

Lizard MCP を使うと、ChatGPT、Claude などの MCP クライアントから Lizard プロジェクトを管理できます。サービスとアドオンの作成、再デプロイ、ログとメトリクスの確認、シークレットの設定、レプリカのスケール、ドメインの割り当てができます。これはホスト型のサーバーで、次の URL で Streamable HTTP を使って通信します:

https://employ-woman-g1q2.us-east-1.onlizard.com/mcp

OAuth に対応したクライアントでは、初回利用時にサインインします。それ以外のクライアントは、Authorization: Bearer ヘッダーで liz_ API キーを送ります。キーは lizard keys create <name> で作成します。

Claude Code に追加する:

claude mcp add --transport http lizard https://employ-woman-g1q2.us-east-1.onlizard.com/mcp

Cursor など、JSON で設定するクライアントの場合:

{
  "mcpServers": {
    "lizard": {
      "url": "https://employ-woman-g1q2.us-east-1.onlizard.com/mcp",
      "headers": { "Authorization": "Bearer liz_your_key" }
    }
  }
}

トライアルの開始、支払い、Pro の解約は Billing ページで行います。何かを作成する前にアカウントの支払いが必要な場合、ツールのエラーには PAYMENT_REQUIRED と開くべきリンクが含まれます。

独自の MCP サーバーをホストする

Lizard CLI を使うエージェントと、MCP を公開するアプリケーションは別のワークフローです。上記の CLI コマンドは MCP トランスポートを提供しません。Streamable HTTP を使って独自のサーバーをデプロイするには、リモート MCP ガイド に従ってください。

関連項目

アプリ ダッシュボード

更新日