ガイド付きセットアップは、SuperDevSpace がこの隙間を埋める方法です。エージェントはアプリ内蔵のブラウザでサイトを開き、許された範囲のクリックを自分でこなし、次の手順があなたの番になったちょうどそのときに、指し示す印と一文を添えてページをあなたに渡します。

「全部エージェントに任せればいい」が間違いである理由

この機能のいちばん簡単な作り方は、ブラウザをまるごとエージェントに渡すことです。すべての項目を読み、すべての欄に入力し、すべてのボタンを押す。速いでしょうが、よくない考えです。セットアップの流れには、エージェントが決して触れるべきでないものがあふれています。

• パスワードと、スマートフォンに届くワンタイムコード
• カード番号、銀行口座の情報、本人確認書類
• あなたが同意する規約と、あなたが承認する支払い

そこで設計は反対側から始めています。エージェントは定型作業を担当します。移動し、正しいページを見つけ、プロジェクト名を入力し、作成 を押す。個人的なことや、拘束力のあることはすべてあなたの手元に残ります。

ガイド付きセットアップの流れ

流れはどのサイトでも同じです。誰も手順を書いていないサイトでも変わりません。

終わったら、シークレットを画面に出さずに結果を確認できます。

$ grep -o '^PADDLE_[A-Z_]*=' .env
PADDLE_API_KEY=
PADDLE_CLIENT_TOKEN=
PADDLE_WEBHOOK_SECRET=
PADDLE_ENVIRONMENT=

アプリが強制するルール

これらはアプリ内のチェックで、エージェントがオフにすることはできません。

• シークレットは入れない、出さない。 エージェントは、パスワード、カード、CVC、IBAN、ワンタイムコード、本人確認の欄に入力できません。ページを読むときやスナップショットを撮るときには、それらの値は隠され、読み取るテキストからも取り除かれます。
• スクリーンショットは塗りつぶされる。 機密性の高い欄と、別オリジンのフレーム（カード入力ウィジェットや「Google でログイン」の枠など）はすべて、エージェントが画像を見る前に覆われます。
• 機密ページではスクリプトを実行しない。 そうした欄を表示しているページでは、ページ内での JavaScript の実行は拒否されます。
• 同意と支払いはあなたのもの。 規約のチェックボックスや「支払う」「注文する」ボタンのクリックは拒否されます。
• すべてが見える。 ブラウザパネルでエージェントが行っていることは、その場でパネルのバナーに表示されます。
• シークレットは会話に出さない。 シークレットとして読み取った値は機密としてマークされ、エージェントはチャット、レポート、タスクのメモ、通知で決して繰り返さないよう指示されます。

連携先のリストではなく、どんな Web サイトでも

ガイド付きセットアップはスクリプトのライブラリではなく、ループです。誰もヒントを書いていないサイトでも動きます。エージェントは目の前にある実際のページを読むからです。いくつかのサービス向けには短いヒントファイルを同梱しています。たとえば Paddle のサンドボックスのダッシュボードや RevenueCat 向けのもので、開発者向け設定がたいていどこにあるかをエージェントに伝えます。ダッシュボードのメニューは頻繁に変わるので、ヒントにははっきりこう書いてあります。ページとヒントが食い違ったら、ページを信じること。

これは見た目以上に大切です。エージェントが書く連携コードは機能の半分にすぎません。残りの半分は、他人の Web サイト上にあるアカウント、キー、Webhook です。ガイド付きセットアップなら、その両方が同じセッションで、同じエージェントとともに進みます。あなたが時間を使うのは、あなたにしかできない手順だけです。

どこに位置づけられるか

ガイド付きセットアップは、SuperDevSpace のほかのすべてと同じワークスペースの一部です。決済の連携コードを書くエージェントが、そのままキーの作成も案内します。そのターミナルの隣のブラウザパネルで。初めての方は、SuperDevSpace を作った理由で、それを取り巻くチームの全体像を紹介しています。

試してみる

トライアルは Premium を 14 日間、カード登録なしで使えます。SuperDevSpace をダウンロードし、プロジェクトに決済や分析のプロバイダーを設定するようエージェントに頼んでみてください。あなたの番が来たら、エージェントがページを渡してくれます。

SuperDevSpace は、manager と複数の worker を 1 つのリポジトリで同時に動かします。この記事では、彼らを互いに切り離す仕組みである git worktree と、それを扱うときにアプリが守っている具体的なルールを説明します。

git worktree とは

git リポジトリには通常、作業ディレクトリが 1 つしかありません。git worktree を使うと、1 つのリポジトリに複数の作業ディレクトリを持たせられます。それぞれが自分のブランチをチェックアウトし、オブジェクトデータベースはすべて共有します。2 つ目のクローンも、履歴の 2 つ目のコピーもありません。新しい worktree にかかるのは、チェックアウト 1 つ分のファイルだけです。

どのリポジトリでも手で試せます。コマンドはどこでも同じで、違うのはシェルだけです。

git worktree add -b agent/frontend-demo ../myrepo-frontend
git worktree list
cd ../myrepo-frontend && git status
cd - && git worktree remove ../myrepo-frontend

git worktree add -b agent/frontend-demo ..\myrepo-frontend
git worktree list
cd ..\myrepo-frontend; git status
cd ..\myrepo; git worktree remove ..\myrepo-frontend

worktree にはそれぞれ専用の HEAD、専用のインデックス、専用のファイルがあります。2 つのプロセスが 2 つの worktree で同時に編集・ビルド・テストをしても、互いの書きかけの変更は見えません。エージェントのチームに必要なのは、まさにこの性質です。

SuperDevSpace での使い方

ルールはシンプルで、どの organization でも同じです。

• manager はメインのチェックアウトで作業します。 計画し、レビューし、マージします。ブランチが合流する唯一の場所です。
• worker はそれぞれ専用のブランチに専用の worktree を持ちます。 manager が worker を採用すると、アプリがその worker のために git worktree add -b <branch> <path> を実行します。ブランチ名は、あなたが名前を付けない限り agent/<worker 名>-<スタンプ> になります。
• worktree はアプリ自身のデータフォルダ、worktrees/<organization>/<worker> の下に置かれ、リポジトリの中には決して作られません。プロジェクトフォルダがエージェントのディレクトリで散らかることはありません。
• ターンごとにコミットされます。 worker がターンを終えると、アプリはその worktree で変わったものをすべてコミットします（agent(<name>): turn）。worker の作業が、コミットされていない作業ディレクトリにしか存在しないという状態は起きません。
• マージはスカッシュマージです。 manager が worker のレポートを受け入れると、ブランチは git merge --squash で 1 つのコミットとしてあなたのラインに取り込まれます。コンフリクトした場合はマージを中止し、コンフリクトの途中で放り出すのではなく、次の操作のためにリポジトリをきれいな状態に戻します。
• リポジトリごとに git 操作は一度に 1 つ。 worktree のディレクトリがファイルを分離し、リポジトリごとのキューが git コマンドそのものを直列化します。2 つの worker が同時に作業を終えても、git のメタデータを奪い合うことはありません。

ボード上では、これが同時に進む複数のタスクとして見えます。タスクごとに担当の worker が違い、その下にはそれぞれ専用のブランチがあります。

実用にするための工夫

作ったばかりの worktree には、git が追跡しているファイルしかありません。プロジェクトを動かすにはたいてい足りません。node_modules、ローカルの .env、生成ファイルなどです。これを 2 つの仕組みで補っています。

リポジトリごとのセットアップスクリプト

リポジトリに .super/scripts/setup-worktree.sh があれば、アプリは worker が動き出す前に、新しい worktree の中でそれを実行します。SUPERDEV_MAIN_REPO にはメインのチェックアウトのパスが入ります。出力はリアルタイムで表示されるので、時間のかかるインストールでも状況がわかり、途中でキャンセルもできます。

#!/usr/bin/env bash
set -euo pipefail
# ローカルにしかないファイルをメインのチェックアウトからコピー
cp "$SUPERDEV_MAIN_REPO/.env" .env 2>/dev/null || true
# 依存関係をインストール（pnpm は共有ストアからリンクするので速い）
pnpm install --frozen-lockfile

サブモジュール

git worktree add はサブモジュールを空のままにします。新しい worktree に .gitmodules があれば、アプリはその中で git submodule update --init --recursive を実行し、依存関係が黙って欠けたままビルドされることを防ぎます。

作業を失わない後片付け

worktree はたまっていきます。アプリは回収しますが、慎重です。

コミットされていない変更がある worktree や、まだあなたのラインに入っていない作業を含むブランチを持つ worktree は、そのまま残ります。消したフォルダは作り直せますが、失った作業は戻りません。ブランチにも同じ慎重さを適用しています。アプリは自分で作ったブランチを記録しており、触るのはそれだけです。

あなたにとって何が変わるか

worker がそれぞれ自分のブランチを持てば、「エージェントを 4 つ同時に動かす」は賭けではなくなります。次のことができます。

• 独立したタスクに分かれる指示を manager に出し、worker たちを並行して動かす
• どの worker の diff も、それを生んだ会話の隣で個別に読む
• ほかの worker を邪魔せずに、1 人の worker の変更だけを却下する
• チームが働いている間も、メインのチェックアウトを自分で使い続ける

人間のチームが使うのと同じ規律を、互いの足を踏みそうになっても教えてくれないエージェントに適用しているだけです。なぜこれを中心にアプリを丸ごと作ったのかは、最初の記事で書いています。

試してみる

14 日間のトライアルは Premium で、カード登録は不要です。SuperDevSpace をダウンロードして新しい organization をリポジトリに向け、manager が最初の worker を採用するたびに worktree が現れる様子を見てみてください。

SuperDevSpace は、この隙間を埋めるために作りました。すでに使っている CLI を小さなチームに変えるデスクトップアプリです。仕事を計画する manager と、それを実行する worker。どちらもそれぞれ専用のターミナルと専用の git worktree で動きます。

ターミナル 1 つにエージェント 1 つ、の問題

コーディングエージェントひとりとの作業は、タスクが 1 つなら快適です。ところが同じリポジトリでやることが 3 つになった瞬間に崩れます。

• 2 つ目のターミナルを開くことはできますが、今度は 2 つのエージェントが同じチェックアウトを編集します。片方がテストスイートを走らせている最中に、もう片方はリファクタリングの真っ最中です。
• あなたがプロジェクトマネージャーになります。仕事を分け、どのターミナルにどのタスクがあったかを覚え、セッションからセッションへコンテキストを写すのはあなたです。
• 何が起きたかを誰も記録しません。昼食から戻ったとき、手がかりはターミナルのスクロールバックだけです。

どれもモデルの問題ではありません。組織の問題です。そして組織化は、ソフトウェアが得意とする仕事です。

SuperDevSpace が実際にやること

SuperDevSpace では、リポジトリ 1 つが 1 つの organization です。各 organization には manager がいます。本物のターミナルで動く本物のエージェント CLI セッションで、画面で見ることも、直接入力することもできます。manager には普段の言葉で指示（ディレクティブ）を出します。キーボードで入力しても、音声入力で話しかけても構いません。

そのあと manager は、チームリードがやることをそのままやります。

いつでも割って入れます。どのエージェントにもチャットビューと本物のターミナルがあります。1 つのセッションを 2 つの見方で見るだけです。変更はすべて、それを生んだ会話の隣に diff として表示されるので、メインラインに入る前に自分で確認できます。

あなたのサブスクリプション、あなたのマシン、あなたのコード

いちばん重要な設計判断は、いちばんシンプルな判断でもあります。SuperDevSpace は、あなたがすでに払っている CLI を動かします。 モデルへのアクセスを再販することはないので、SuperDevSpace のサブスクリプション以外に、実行した内容が私たちからの請求に載ることはありません。

この判断には、私たちが気に入っている帰結があります。

• エージェントはあなたのマシン上のローカルプロセスとして、ローカルのリポジトリに対して動きます。ソースコード、プロンプト、ターミナルの出力、ファイルパスが私たちのサーバーに送られることはありません。アカウントサービスが保存するのは、アカウント、サブスクリプションの状態、デバイスの一覧だけです。
• CLI は organization ごとに選べます。 Claude Code、OpenAI Codex、Gemini CLI、Aider、Qwen Code、Cursor CLI、OpenCode から選択できます。現時点でアプリが最も深く扱えるのは Claude Code です（フック、セッション再開、MCP ツール、権限への応答）。残りの 6 つも起動して動作します。アプリはそれらを実験的と表示し、まだつながっていない機能を、黙って失敗する代わりに教えてくれます。
• 私たちのクラウドに閉じ込められるものはありません。 仕事をしているクラウドがそもそも存在しないからです。

最初の指示を出す前に、CLI とリポジトリが想定どおりの場所にあるか確認しておくと安心です。

$ claude --version
$ cd ~/code/your-project
$ git status

チームを支える周辺機能

チームにはターミナル以上のものが必要です。どのプランにも含まれるものをいくつか紹介します。

• 事実を語るボード。 スプリント、タスク、ブリーフ、レポート。レポートには、うまくいったことだけでなく失敗したことも書かれます。
• Inspector。 動いている Web ページの要素をクリックすると、コンポーネント、ファイル、行番号を添えてエージェントに送れます。Vite、Next.js、静的サイトに対応しています。
• スマートフォンからの承認。 エージェントに判断が必要になると、あなたに尋ねます。スマートフォンアプリにはボード、エージェント、保留中の承認が表示されるので、席を離れていても権限の確認に答えられます。
• organization ごとのホワイトボード（Excalidraw）。エージェントが読むことも、描き込むこともできます。

Premium では、さらに踏み込んだ機能が加わります。Penpot をベースにしたデザインモードと、ファイルに直接描く Designer エージェント。指示を決まった時刻に実行するスケジュール。そして Mac 上の manager が Windows PC 上の manager に仕事を渡せるピアリンクです。詳しい比較は料金ページにあります。

約束しないこと

エージェントのチームにも、やはりボスが必要です。何を作るかを決めるのも、メインブランチに入れるものを承認するのも、あなたです。

試してみる

トライアルは Premium を 14 日間、カード登録なしで使えます。CLI のサブスクリプションもコードも、あなたのものです。自分のリポジトリでチームが働く様子を見たいなら、SuperDevSpace をダウンロードして、manager に最初の指示を出してみてください。