kernel-cli

Kernel CLI

Kernel CLI を使用すると、ブラウザーの自動化、サーバーレスアプリのデプロイ、インフラストラクチャの管理のために、Kernel のクラウドブラウザープラットフォームにコマンドラインからアクセスできます。

インストール

• Homebrew：brew install kernel/tap/kernel
• npm：npm install -g @onkernel/cli

kernel --version で確認します。インストール済みのバージョンについては、kernel <command> --help を正確な情報源として使用してください。

認証

• 推奨： KERNEL_API_KEY 環境変数を設定します
• 代替手段： kernel login を実行して、対話型 OAuth を使用します

クイックスタート

# Authenticate
export KERNEL_API_KEY=your_api_key

# Create a browser session
kernel browsers create -o json

# Run Playwright automation (use `return` to get a value back)
kernel browsers playwright execute <session_id> '
  await page.goto("https://example.com");
  return await page.evaluate(() => document.title);
'

# Take a screenshot
kernel browsers computer screenshot <session_id> --to screenshot.png

# Cleanup
kernel browsers delete <session_id>

安全な操作

• スクリプトでは -o json と jq の使用を推奨します。deploy と invoke は、単一の JSON オブジェクトではなく JSONL を出力します。
• API キーが複数のプロジェクトにアクセスできる場合は、--project <id-or-name> または KERNEL_PROJECT を使用します。
• 破壊的な操作では、非対話型の実行が意図的な場合を除き、確認プロンプトを有効にしておきます。
• テスト後は、作成したブラウザーセッションとプールを削除します。API キー、認証情報、プロキシパスワードを表示、ログへの記録、コミット、共有しないでください。

プロジェクト、API キー、組織の管理

# Rename, archive, or reactivate a project (provide at least one update)
kernel projects update <id-or-name> --name <new-name> -o json
kernel projects update <id-or-name> --status archived -o json
kernel projects update <id-or-name> --status active -o json

# Look up a soft-deleted API key
kernel api-keys get <id> --include-deleted -o json

# Inspect limits before changing the default project cap
kernel org limits get -o json
kernel org limits set --default-project-max-concurrent-sessions <n> -o json

org limits set では、0 を指定するとデフォルトの上限が解除されます。値は組織の同時実行数の上限を超えることはできません。

kernel api-keys rotate <id> を対話形式で実行すると、API キーをローテーションできます。--days-to-expire <1-3650> で新しいキーの有効期間を設定し、--expire-in-days <n> で古いキーの猶予期間を設定します（デフォルトは 7 日、0 を指定すると直ちに失効します）。出力には新しいキーの平文が一度だけ含まれます。ログに記録せず、猶予期間中に呼び出し元を移行してから、古いキーが使えなくなったことを確認してください。

リファレンス

• ブラウザー管理 - ブラウザーセッションの作成、一覧表示、表示、削除
• アプリのデプロイ - TypeScript/Python アプリのデプロイとアクションの呼び出し
• コンピューター制御 - OS レベルのマウス、キーボード、スクリーンショット機能
• プロセス実行 - ブラウザー VM でのプロセスの実行と管理
• プロファイル - 永続的なブラウザープロファイルの管理
• 認証管理 - 認証接続、ログインセッション、認証情報プロバイダー、自動再認証
• プロキシ - データセンター、ISP、住宅用、モバイルプロキシの作成と管理
• ブラウザープール - 起動済みブラウザープールの管理
• 拡張機能 - Chrome 拡張機能のアップロードと管理
• リプレイ - ビデオリプレイの記録とダウンロード
• ファイルシステム操作 - ファイルの読み取り、書き込み、アップロード、ダウンロード