ドキュメント / 基本概念
AIステージング
AIステージングのチャットパネルで、希望するワークスペースを説明します(特定のアプリ、ウインドウ、ステージ、モニターは@で指定できます)。AIが開いているウインドウ(タイトル、URL、ファイルパス)を分析し、ステージのプランを提案します。プランは確認、調整、適用でき、ワンステップで取り消すこともできます(パネル内でCmd-Z)。Proライセンスで自分のAIプロバイダーのキーを使うか、APIキーも設定も不要なマネージドサブスクリプションBetterStage AIで利用できます。
仕組み
AIステージングは、すべてのモニター上の開いているウインドウをすべてスキャンしてメタデータ(アプリ名、ウインドウタイトル、書類のパス、URL)を収集し、AIモデルに送信します。送信先は、自分のプロバイダー(自分のAPIキーを使用)か、BetterStage AIを購読している場合はBetterStageのマネージドサービスです。モデルは、名前付きのステージを作成し、各ウインドウを適切なステージとモニターに割り当てるプランを返します。
- スキャン — BetterStageが、開いているすべてのウインドウのタイトル、書類のパス、URL、アプリ名を読み取ります。
- 分析 — データがAIプロバイダー(自分のプロバイダー、またはBetterStage AIのサブスクリプションならBetterStageのマネージドサービス)に送信されます。チャットパネルには進行状況がリアルタイムで表示され、提案されたアクションはアシスタントの回答に添えられます。
- 確認と適用 — 新しいステージが作成され、各ウインドウが各ステージの適切なモニターに割り当てられます。BetterStageは、各モニターにまとめられた内容に合わせてウインドウモード(拡張ネイティブまたはTabStack)も選択します。リクエストで特定のモードを指定することもできます。プランは適用前に調整でき、適用した変更はまとめて後から取り消せます。
AIステージングの起動
AIステージングを実行する方法は4つあります:
- キーボードショートカット — Opt+Z(ヨーロッパ配列ではCtrl+Opt+Z)、または「設定 > ショートカット」で設定した独自の割り当てを押します。
- メニューバー — メニューバーのBetterStageアイコンをクリックし、AIステージング…を選択します。
- スナップホイール — スナップホイールを開き、ワークスペースのサブメニューからAIステージングを選択します。
- 設定 — 設定 > AIステージングを開いてプロバイダーを設定し、そこから実行します。
プロバイダーの設定
自分のAPIキーを使う場合、AIステージングはプロバイダーと直接通信し、データがBetterStageのサーバーを経由することはありません(BetterStage AIのサブスクリプションでは、リクエストはBetterStageのマネージドサービスを経由します。キーは不要です)。プロバイダーは設定 > AIステージングで設定します。BetterStageには25のプロバイダープリセットが用意されています:OpenAI、Claude (Anthropic)、Google Gemini、OpenRouter、Groq、Together AI、Mistral、xAI (Grok)、DeepSeek、Moonshot (Kimi)、Zhipu (GLM)、Alibaba Qwen、MiniMax、Tencent Hunyuan、ByteDance Doubao、NVIDIA NIM、Hugging Face、Azure OpenAIなど。OllamaやLM Studioといったローカルサーバーにも対応しています。
- 最新のモデル一覧 — プリセットを選ぶと、そのキーで実際に使えるモデルをBetterStageが取得します。
- 地域の選択 — 地域ごとにエンドポイントがあるプロバイダー(Qwen、Moonshot、Zhipu、MiniMax、SiliconFlow)では、国内向けと国際向けのベースURLを切り替えられます。
- プロバイダーごとのAPIキー — 各プロバイダーがそれぞれのキーを記憶するので、プリセットを切り替えてもキーが失われることはありません。
- カスタムエンドポイント — 「カスタム(OpenAI互換)」プリセットでは、プロキシやセルフホストのサーバーなど、任意のベースURLとモデル名を指定できます。
| プロバイダー | デフォルトのモデル | 認証 |
|---|---|---|
| OpenAI | gpt-4.1-mini | APIキー(Bearerトークン) |
| Claude (Anthropic) | claude-sonnet-4-6 | APIキー(x-api-keyヘッダー) |
| Ollama (local) | インストール済みのモデル | なし(localhost) |
| カスタム(OpenAI互換) | 任意 | APIキー(Bearerトークン) |
その他の22のプリセットも同じOpenAI互換の方式で、ベースURLとデフォルトのモデルがあらかじめ入力されています。
接続をテスト
設定 > AIステージングには、設定したモデルに実際のチャットメッセージを送信する接続をテストボタンがあります。これで、エンドポイント、キー、モデルがすべて実際に機能することを事前に確認できます。設定の問題はリクエストの前に検出され、プロバイダーのエラーをそのまま表示する代わりに、わかりやすいメッセージと「設定を開く」ボタンが表示されます。
保存されたレシピ
レシピは、ワークスペースをどのように配置するかを指示として保存したものです。コーディング、デザインレビュー、サポート、執筆など、繰り返し行うワークフローごとに別々のレシピを用意できます。AIステージングのパネルでは、レシピの切り替え、新規作成、既存のレシピの複製や名前の変更、古いレシピの削除、新しいセッションで使うデフォルトのレシピの選択ができます。
AIステージングを実行すると、選択中のレシピが含まれます。レシピはチャットと同じ@メンションのチップ(モニター、ステージ、ウインドウ、アプリ、ウインドウモード)で編集でき、モデルに送信される実際のプロンプトをプレビューし、パネルから直接配置を実行できます。
レシピのメモの例:
- 「チャットアプリと音楽は小さいサブモニターに置いて。プロジェクトのドキュメントを開いたブラウザのタブはエディタの隣に。」
- 「Slack、Discord、メール用の連絡ステージを必ず作成して。」
- 「可能ならクライアント名でまとめて。」
送信されるデータ
AIステージングは、ワークスペースのスナップショットをAIモデルに送信します。自分のAPIキーを使う場合はプロバイダーに直接送信され、BetterStageのサーバーがそれを見ることはありません。BetterStage AIのサブスクリプションでは、BetterStageのマネージドサービスを経由します。スナップショットには以下が含まれます:
- ウインドウのメタデータ — アプリ名、ウインドウタイトル、書類のファイルパス、コンテンツのURL(ホスト+パス)
- モニターの配置 — ディスプレイ名、配置の順序、フレームの範囲、メイン/サブの区別
- システムの制約 — 最大ステージ数、ステージあたりの最大ウインドウ数
ファイルの内容、スクリーンショット、キー入力は送信されません。ただし、ウインドウタイトル、ファイルパス、URLには機密性の高いプロジェクト名や書類名が含まれる場合があるため、信頼できるプロバイダーを選んでください。
必要条件
- Proライセンス — AIステージングはPro機能です。
- AIプロバイダー — 対応する25のプロバイダーのいずれか(または任意のOpenAI互換エンドポイント)の自分のAPIキー、あるいはキー不要でAIを実行するBetterStage AIのサブスクリプション。
- インターネット接続 — クラウドのプロバイダーを使う場合に必要です。ローカルサーバー(Ollama、LM Studio)はオフラインで動作します。