ドキュメント
インストールから、AIエージェントのチームがあなたのリポジトリで作業するまでに必要なことをすべてまとめています。アプリのウェルカム画面にも同じ案内がありますが、このページはインストール前に読める版です。
必要なもの
SuperDevSpace は、すでにお持ちのエージェントCLIを動かします。初回起動の前に、次のものを用意してください:
- Apple シリコン搭載の macOS 13 Ventura 以降、64ビット版 Windows 10 または 11、または64ビット版 Linux(Ubuntu 22.04+、Debian 12+、Fedora 38+)。
- Git と、チームに作業させたいリポジトリのローカルクローン。
- インストール済みでサインイン済みのエージェントCLIを少なくとも1つ — Claude Code、OpenAI Codex、Gemini CLI、Aider、Qwen Code、Cursor CLI、OpenCode。アプリが見つかったCLIを確認し、それ以外のインストールコマンドを案内します。
- そのCLIのサブスクリプションまたは API キー。それはあなたとそのプロバイダーとの間のものであり、SuperDevSpace が見ることも、モデルへのアクセスを再販することもありません。
インストールとサインイン
インストーラーはダウンロードページから入手できます。どのビルドが公開済みかもそこに表示されます。macOS 版(Apple シリコン)は署名・公証済みで、自動でアップデートされます。Windows インストーラーはまだコード署名されていないベータ版から始まるため、SmartScreen が一度だけ確認を求めます(詳細情報 › 実行)。Linux では AppImage(自動アップデート対応)か、パッケージマネージャーに合わせた .deb / .rpm をお使いください。公開しているすべてのファイルに SHA-256 を記載しているので、開く前に確認できます。
初回起動時に、アカウントの作成またはサインイン(メール、Google、GitHub、Apple)を求められます。新しいアカウントでは、カード不要の14日間 Premium トライアルが始まります。アカウントが保持するのはサブスクリプションとデバイス一覧だけで、コードに関する情報は一切含みません。
最初の組織
SuperDevSpace では、リポジトリごとにひとつの「組織」があります。専用のチーム、ボード、メモリーを持つ単位です。ウェルカム画面が3つのステップで案内します:
- 組織を追加する: 名前を付け、リポジトリのフォルダを指定します。
- チームを選ぶ: ロール(フロントエンド、バックエンド、QA、レビュアー、デザイナーなど)を選び、各エージェントに名前と、必要なら追加の指示を与えます。あとから追加することもできます。
- マネージャーを起動する: 実際のエージェントCLIセッションとして、目で見て入力もできるターミナルタブで開きます。
指示を出す
やりたいことを普通の言葉でマネージャーに伝えます。ターミナルやチャットに入力しても、音声で伝えても構いません。マネージャーはリードエンジニアと同じように動きます:
- スプリントを開き、指示をボード上のタスクに分解して、それぞれに短いブリーフを付けます。
- タスクごとにワーカーを採用します。各ワーカーは専用のターミナルタブで動く独立したCLIセッションで、専用の branch 上に専用の git worktree を持ちます。
- 各ワーカーのレポートをレビューし、branch をあなたのブランチに squash merge し、問題があれば修正を依頼します。
- 最後に、まとめたレポートを1つお渡しします。
いつでも介入できます。すべてのエージェントにチャットビューと実際のターミナルがあり、すべての変更はそれを生んだ会話の隣に diff として表示されます。
worktree とセットアップスクリプト
ワーカー同士がチェックアウトを共有することはありません。各ワーカーには、アプリ専用のデータフォルダ内(リポジトリの中ではありません)に git worktree が用意され、完了したターンはすべてワーカーの branch に commit されます。未コミットのフォルダにしか存在しない変更は残りません。
新しい worktree には git が追跡しているものしかありません。リポジトリに .super/scripts/setup-worktree.sh があれば、アプリはワーカーの起動前に新しい worktree ごとにそれを実行します。その際 SUPERDEV_MAIN_REPO はメインのチェックアウトを指します。サブモジュールは自動で初期化されます。
#!/usr/bin/env bash
set -euo pipefail
# Copy local-only files from the main checkout
cp "$SUPERDEV_MAIN_REPO/.env" .env 2>/dev/null || true
# Install dependencies
pnpm install --frozen-lockfile
承認と質問
エージェントが判断を必要とするとき — 権限の確認や、2つのアプローチからの選択など — 推測せずにあなたに尋ねます。質問はワークスペースの上部に表示され、回答するまで残ります。
同じボード、エージェント、未回答の質問を表示するスマートフォン用コンパニオンを App Store で公開予定です。現在は招待制のベータです。
指さすだけで Web ページを直す
ブラウザペインでアプリの開発サーバーを開き、要素を選びます。Inspector はカーソル下のコンポーネント階層を、それぞれのファイルと行番号付きで表示し、要素、スクリーンショット、あなたのメモをエージェントに送ります。Vite、Next.js、静的サイトに対応しています。
CLIの選び方
CLIは組織ごとに選びます。現時点でアプリが完全に使いこなせるのは Claude Code です — hooks、resume、MCP ツール、権限確認への応答まで。残りの6つも起動・実行できます。アプリはそれらを実験的と表示し、黙って失敗する代わりに、まだ連携していない機能を明示します。
マシンの外に出るもの
エージェントはローカルのプロセスとして、ローカルのリポジトリに対して動作します。ソースコード、プロンプト、ターミナル出力、ファイルパスが当社のサーバーに送られることはありません。アカウントサービスが保存するのは、アカウント、サブスクリプションの状態、デバイス一覧です。すべての項目はプライバシーポリシーに記載しています。
困ったときは
試したことと表示された内容を添えて [email protected] までご連絡ください。担当者が読みます。セキュリティに関する報告は [email protected] へお送りください。