Antigravityに既存のプロジェクトを取り込むとき、新規プロジェクトを作ってファイルを手で移す必要はありません。「フォルダーを開く」でプロジェクトのルートを渡せば、エージェントが既存のコードと構造を読み取ります。初心者に一番多い間違いは、空のプロジェクトを作ってから手動でコピーすることで、設定やGit履歴を失うおそれがあり、手間も増えます。
状況に合わせた3つの開き方
- ローカルにコードがある場合:スタート画面で「フォルダーを開く」を選び、プロジェクトのルートを指定します。親フォルダーやデスクトップを選ばないでください。
- コードがGitHubにある場合:「Gitリポジトリをクローン」を選び、リポジトリのアドレスを入力すると、Antigravityがコードを取得してから開きます。
- VS CodeやCursorからの乗り換え:初回起動時に設定のインポートを選ぶと、テーマ、拡張機能、キーバインドを一緒に持ち込め、編集の習慣を変えずに済みます。
- Firebase Studioからの移行:Googleが専用の移行手順を公開しています。zipをエクスポートしてローカルで解凍してから開き、複雑なプロジェクトは公式の移行プロンプトに沿ってエージェントに進めさせます。
取り込んだ直後にやる4つのこと
- まずプロジェクトを読み込ませる:エージェントはファイル構造や関数名を走査します。インデックスが終わる前にタスクを出すと、回答がずれやすくなります。
- Gitの状態を確認する:ブランチと未コミットの変更があることを確かめ、編集の前に一度コミットしておくと、いつでも戻せます。
- .geminiディレクトリを確認する:プロジェクト単位の設定はここにあります。別のパソコンに移すときはこのディレクトリも一緒にコピーし、コードだけをコピーするとセッションやルールが失われます。
- 小さなタスクで試す:入力欄に/planと入力し、エージェントにまず計画を出させてからコードに触らせ、計画がよければ編集に進みます。
踏みやすい3つの落とし穴
- ドライブ全体や親フォルダーをプロジェクトとして開かないこと:無関係なフォルダーまでコンテキストとして扱われ、遅くなるうえ誤った提案を招きます。
- セッションはフォルダーと一緒に移動しません。公式のセッション移行ツールは今のところなく、パスやパソコンを変えると古い会話が引き継げない場合があります。大事な結論は先に文書に残してください。
- 複数リポジトリのプロジェクトはマルチフォルダーワークスペースで:パスが違うリポジトリはそれぞれ権限を設定でき、1つのルートに無理に詰め込む必要はありません。