【Fedora Linux × IntelliJ】新世代AIエージェント Antigravity 導入・連携ガイド
🚀 すべての始まり:IDEへの通知
いつものようにIntelliJ IDEAを開いて作業をしていたところ、開発環境に一通の重要な通知が届きました。
リンクを開いて飛び込んできたのは、Google開発者ブログのこちらのタイトル。
「An important update: Transitioning Gemini CLI to Antigravity CLI」
内容を確認すると、従来のGemini CLIは新世代のAIエージェントプラットフォーム
Google Antigravityへと完全移行するとのこと。
「これは早めに環境を作っておかないとマズイ!」ということで、筆者の開発環境
Fedora Linux + zshに導入し、IntelliJとガッチリ連携させるまでの試行錯誤と手順をまとめました。
💡 Antigravity Artifacts とは?
本格的な手順に入る前に、今回の移行で最も強力な新機能である Antigravity Artifacts について簡単に触れておきます。
このAntigravity CLI(
agy)は、ローカルLLM環境でお馴染みの Ollamaと同様にGo言語で開発されており、シングルバイナリで非常に軽量かつ高速に動作するのが技術的な特徴です。そのGo製の強固なバックエンドを活かして提供されるのが、
Artifacts機能です。
一言で言うと、AIが生成した成果物(設計図、コード修正案、ドキュメントなど)が自動的にストックされてエディターの右パネルに設置される 機能です。
従来のAIチャットのように会話ログの中に長大なソースコードが埋もれてしまうことがなく、生成されたファイルはすべて右側に美しく整理されます。
そこからダブルクリックするだけで、直接IntelliJなどのエディタで開いて確認・即座にプロジェクトへ適用できるという、開発効率を爆発的に高める仕組みになっています。
🧠 スクリプトが .gemini/antigravity-cli/brain/...
に格納されるメリット
Antigravityがプロジェクトのフォルダ内ではなく、あえてホームディレクトリ直下の独立した共通領域(
~/.gemini/antigravity-cli/brain/)に成果物を集約して格納することには、非常に強力なメリットがあります。
-
「記憶喪失」の完全克服
- 従来のツールにあったバージョン更新やセッション切れのたびに会話の記憶がリセットされるというモヤモヤを完全に解決。
- 永続的なブレイン領域にデータが保持されるため、いつでも前回の続きから作業を再開できる。
- 従来のツールにあった
-
異なるエディタ・環境間でのコンテキスト共有
- 特定のIDEやフォルダに依存しないため、ターミナルとメインのエディター間で、成果物の情報をシームレスに引き継ぎ可能。
-
プロジェクトディレクトリを汚さない安全性
- 生成された修正案やドキュメントが、プロジェクト内にいきなり書き込まれてGitの差分を汚すリスクを回避。
- 右側のArtifactsパネルから、人間の承認を経て初めて安全にプロジェクト側へ反映される設計。
-
MCP(Model Context Protocol)によるシームレスな同期
- エディタやターミナルと
Antigravity CLI
が、共通の標準プロトコル(MCP)を介して通信。 - 共通領域に書き出された成果物を、IntelliJ側の要求に応じてMCP経由で受け渡し、右側のArtifactsパネルへスマートに同期・表示する仕組み。
- エディタやターミナルと
- エディタやターミナルと
📂 データが流れるディレクトリ構造の全体像
裏側でどのようなデータのやり取りが行われているか、構造図にすると以下のようになります。
[あなたのPCのホームディレクトリ]
├── 📁 .gemini/
│ └── 📁 antigravity-cli/
│ └── 📁 brain/
│ └── 📁 3eed7579-e47f-46.../ (セッション毎の固有ID)
│ └── 📝 code_explanation.md <-- 【ココに実ファイルが生成される!】
│
└── 📁 あなたの開発プロジェクト/ (作業ディレクトリ)
└── (IntelliJ IDEA で開いている場所)
1. Antigravity CLI のインストールと環境設定
https://antigravity.google/download 今回は公式に沿ってシェルスクリプト経由curl方式でインストールを行います。
① CLI本体のインストール
ターミナルを開き、以下のコマンドを実行します。
curl -fsSL https://antigravity.google/cli/install.sh | bash
② zshへのパス(PATH)の追加
~/.local/binに配置された
agyコマンドをシステムに認識させるため、
~/.zshrcに以下の設定を追記して反映させます。
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
📌 パスについての補足:
※すでに他のローカルツール等を入れていて ~/.local/bin にパスが通っている環境であれば、この追記手順(PATHの設定)は不要です。
ターミナルで agy と叩いてそのまま起動すれば、このステップは飛ばしても問題ありません。
③ パスの確認
正常にパスが通ったかは、以下のコマンドで確認できます。
whereis agy # または which agy # 出力例: /home/YOUR_USERNAME/.local/bin/agy
④ 🔄 今後のアップデート方法
今回の手順(curl方式)でインストールした最大の強みは、今後のメンテナンスが楽な点です。
新しい機能の追加やAIモデルの最適化など、Antigravityにアップデートが届いた際は、ターミナルで以下のコマンドを一発叩くだけで一般ユーザー権限のまま、いつでも最新バージョンに自動更新できます。
agy update ⟳ Checking for updates... (current version 1.0.2) ✓ You are already on the latest version.
2. 初回起動時の対話型セットアップと注意点
パスが通ったら、ターミナルで
agyを実行して初期設定を開始します。
① 認証方法(Login Method)の選択

- 個人利用(Google AI Pro/Ultraプランや無料枠)の場合は、を選択してEnterを押します。
1. Google OAuth
- ブラウザが自動的に立ち上がるので、ご自身のGoogleアカウントでログインを承認します。
② カラーテーマの選択とデータ同意

- ターミナル上での配色(
terminal
,dark
,tokyo night
など)を矢印キーで選択し、右側のプレビューを見ながら好みのものを決定します。 - その後、データ利用(品質改善のためのデータ送信)への同意確認画面を進め、
[Done]
で確定させます。
③ ワークスペースの信頼確認(Accessing workspace)
セットアップが完了し、現在の作業ディレクトリにアクセスする際、最後のセキュリティ防壁として信頼確認が行われます。

内容: Antigravityはローカルファイルを読み書きしたり、コマンドを自律実行したりする強力な権限を持つため、このディレクトリ(画像では /home/YOUR_USERNAME)はAIに触らせても安全な場所ですか?」と確認を求めています。
決定: 自分が管理している安全なプロジェクトフォルダであれば、そのまま > Yes, I trust this folder を選択して Enterキー を押します。
④ プロジェクトフォルダの信頼確認
| 信頼確認 | 起動画面 |
|---|---|
3. IntelliJ IDEA(Antigravity Companion)との紐付け

CLI単体でも動作しますが、真価を発揮させるためにJetBrainsのプラグインから
Antigravity Companionをインストールし、IDEと合体させます。
① パスの紐付け設定
- IntelliJの
Settings(設定) → Tools → Antigravity Companion
を開きます。 - Path to agy executableの入力欄に、先ほど確認したCLI本体のフルパスを指定します。

whereis agy # または which agy # 出力例: /home/YOUR_USERNAME/.local/bin/agy
(※環境によっては絶対パス /home/YOUR_USERNAME/.local/bin/agy で記述してください)
3.
Applyまたは
OKを押して保存します。
② セッションの起動

- 設定を終えたら、IntelliJの画面右上のツールバーに追加された Start Antigravity Sessionボタンをクリックします
(※反映されない場合はIntelliJを一度再起動してみてください)。 - これにより、画面下部のツールウィンドウに「Antigravity」専用タブが開き、エディタの内容(アクティブファイルや選択範囲)をAIが自動的に把握できる同期状態が完了します。右側には先述の「Antigravity Artifacts」パネルも出現します。
4. おわりに(終了コマンド)
Antigravityの対話セッションを終了させたいときは、プロンプトに以下を入力して Enter を押すことで、セッションをクローズできます。

これまでのチャット欄にコードを手動でコピペして、返ってきたコードをまた手動でコピペして直す という時代は終わり、MCPプロトコルを介してAIエージェントがIDEのコンテキストを勝手に読み、裏側で成果物をArtifactsに整えてくれる時代が来ました。
筆者のFedora Linux環境でも軽快に動作しています。 ぜひ皆さんもこの快適な開発環境を構築してみてください!