CLI リファレンス

lizard CLI はプラットフォームへの主要なインターフェースです。このページでは、インストール、グローバルフラグ、終了コード、実行時検出について扱います。各コマンドにはサイドバーに専用のリファレンスページがあります — lizard up、lizard service、lizard secrets などを参照してください。

CLI v0.3.62 を基準に生成されたリファレンスです。任意のコマンドの正確でバージョン一致のスキーマを確認するには、lizard <cmd> --help --json を実行してください。

インストールとアップグレード

npm install -g @lizard-build/cli
lizard --version
lizard upgrade            # update to the latest version
lizard upgrade --check    # check without installing

必ずグローバルにインストールされた lizard バイナリを使用してください — npx ではありません。権限エラーの修正については Quickstart を参照してください。

認証

lizard login                  # browser OAuth
lizard login --token lzd_xxx  # token auth
lizard logout
lizard whoami                 # current user, workspace, linked project

CI では、login を実行する代わりに、環境変数に LIZARD_TOKEN を設定してください。

グローバルフラグ

ほとんどのコマンドは、リンク済みのものではなく特定のリソースを対象にするために、-p, --project、-s, --service、-w, --workspace も受け付けます。

終了コード

実行時検出

CLI は自己文書化されています。完全なコマンドツリー、グローバルフラグ、終了コードを確認するには、次を実行します。

lizard --help --json

任意のコマンドまたはサブコマンドの正確な引数とオプションを確認するには、次を実行します。

lizard <cmd> --help --json
lizard <cmd> <sub> --help --json     # e.g. lizard service set --help --json

これは常にインストール済みのバージョンを反映します — フラグの形式を推測するよりこちらを優先してください。また、これはエージェントが CLI について事前学習されていなくても CLI を学習する方法でもあります: Claude Code からのデプロイ を参照してください。

設定と状態

• CLI は認証情報と現在のディレクトリのプロジェクトリンクを ~/.lizard/config.json に保存します。
• lizard status は cwd の workspace/project/service リンクを表示します（認証不要）。
• lizard config apply は lizard-config.json ファイルをプロジェクトに適用します（プレビューには --dry-run を使用）。

Sandbox のボリューム

プロジェクト内の Persistent Volumes を名前で管理します。

lizard volume create agent-workdir --size 10 --project proj_123
lizard volume list --project proj_123
lizard sandbox create --volume agent-workdir --project proj_123

名前はプロジェクト内で一意で、小文字の英字、数字、ハイフンを使った64文字以内です。先頭と末尾は英字または数字にします。新規ボリュームは1〜50 GB の整数を受け付け、既定値は5です。CLI は作成前にサーバーの現在の制限を取得し、設定変更に従います。既存の大きなボリュームはサイズを維持します。

切断後に lizard volume rm agent-workdir --project proj_123 を実行すると、ボリュームとデータを削除します。volume list は名前を表示し、--json は生成された ID も含めます。