壁紙アプリの iOS 版を Xcode で触りながら、同じ Antigravity のエージェントを Zed でも JetBrains でも呼べるようにしておきたい——そう考えて、各エディタの登録手順を一枚に並べた日がありました。
Antigravity CLI には agy acp という ACP(Agent Client Protocol)サーバーが入っていて、エディタはこれを子プロセスとして起動し、標準入出力の JSON-RPC で会話します。公式の説明では「Android Studio 以外は、どのクライアントも agy に引数 acp を一つ渡すだけ」とされています。
ところが、Zed の settings.json に書いた数行を他のエディタへそのまま貼ると、動かない箇所が出てきます。私自身、最初は「同じコマンドなのだから、コピーで済む」と思い込んでおりました。並べてみて分かったのは、変わるのはコマンドではなく、その周りだということです。
最初にお伝えしたいのは、移行で変わるのは3か所だけということ
公式ドキュメント(Other editors (ACP))を読み比べると、エディタをまたいで変わるのは次の3つに絞れます。
- 設定のキーと置き場所(
agent_serversなのかacp.agentsなのか、ファイルなのか画面なのか) - コマンドのパス(
agyで通るのか、絶対パスが要るのか) - 認証と、選べるモデル(API キーをどこに置くか、他社モデルが出てくるか)
逆に言えば、エージェント本体・ツール・権限ルール・サインイン情報は Antigravity CLI 側から来るので、移行しても変わりません。ここを分けて考えると、移行の作業はずっと小さくなります。
1か所目:設定のキーと置き場所
いちばん目に見える違いです。同じ「Antigravity を登録する」でも、書く場所と形が4通りあります。
| エディタ | 置き場所 | キー | Zed との差 |
|---|---|---|---|
| Zed | settings.json(zed: open settings file) | agent_servers | 基準。"type": "custom" が付く |
| VS Code | ユーザーの settings.json | acp.agents | ネイティブ対応がなく、コミュニティ製の ACP Client 拡張が必要。type は書かない |
| JetBrains IDE | ~/.jetbrains/acp.json | agent_servers | キー名は同じでも type がなく、command は絶対パス |
| Xcode | Settings > Intelligence > Add an Agent | (画面入力) | ファイルではなく Command と Arguments の欄に入れる |
JetBrains は Zed と同じ agent_servers というキー名を使うので、つい丸ごと貼りたくなります。ただ、"type": "custom" は Zed の書式で、JetBrains の公式例には出てきません。キー名が同じだからこそ、混ぜないように気をつけたいところです。
なお Android Studio だけは ACP Registry からの導入で、この表の書き方とは別の手順になります。
2か所目:コマンドのパス
Zed では "command": "agy" で動いていても、JetBrains と Xcode では動かないことがあります。公式の注意書きは次のとおりです。
- JetBrains IDE は、シェルの
PATHを必ずしも引き継ぎません。which agyの絶対パスを書きます。 - Xcode は
~を展開せず、シェルのPATHも読みません。Command 欄は絶対パスにします。
Homebrew などで入れた CLI は、ターミナルからは見えても、Dock から起動したアプリからは見えない——macOS ではよくある話です。「ターミナルで agy acp --help が通るのに、エディタでは起動しない」なら、私はまずここを疑うようにしています。
もう一つ、Xcode の Arguments 欄について。公式手順に書かれているのは acp の1語だけで、--sandbox のような追加フラグをこの欄にどう並べるかまでは書かれていません。Zed で ["acp", "--sandbox"] のようにフラグを足している方は、Xcode に移したあとで、実際にサンドボックスが効いているかを一度確かめておくと安心です。
3か所目:認証と、選べるモデル
agy acp は、対話モードの agy で一度サインインしたときの資格情報を使い回します。資格情報がない状態だと、リクエストは Authentication required(コード -32000)で失敗します。SSH 先やブラウザのない環境では agy acp --login を端末で先に済ませる、というのが公式の案内です(SSH 越しの症状は Zed の SSH 先で Antigravity のサインインが戻ってこないとき で詳しく書きました)。
移行で気をつけたいのは、Zed の設定に env で GEMINI_API_KEY を書いていた場合です。公式ドキュメントにも「エディタの設定ファイルは平文で保存され、同期や共有されやすい」という注意があります。Zed で一度そう書いてしまっていても、移行先へ同じ行を写す理由にはなりません。資格情報は CLI に預け、エディタの設定にはコマンドだけを書く——移行は、この線を引き直すよい機会だと思います。
もう一つの差は、選べるモデルです。Gemini のモデルはどのクライアントでも使えますが、他社モデルが選択肢に出るのは JetBrains IDE(JetBrains Air を含む)・Android Studio・Android Performance Analyzer・Zed・Xcode に限られます。VS Code の ACP Client 拡張はこの一覧に入っていません。 Zed で他社モデルを使っていた方が VS Code へ移ると、モデルの一覧が短くなるはずです。不具合ではないので、慌てて再インストールしなくて大丈夫です。
Zed の設定から、移行先の書き方を書き出す
3か所の差を毎回手で直すのは面倒なので、Zed の settings.json を読んで、VS Code・JetBrains・Xcode 用の書き方を出力する小さなスクリプトを用意しました。Zed の設定はコメントや末尾のカンマを含むことがあるため、素の json.loads では読めません。そこだけ前処理しています。
#!/usr/bin/env python3
"""Zed の agent_servers から Antigravity の登録を読み、他エディタ用の設定を書き出す。"""
import json, re, shutil, sys
from pathlib import Path
def load_jsonc(path: Path) -> dict:
text = path.read_text(encoding="utf-8")
out, i, in_str = [], 0, False
while i < len(text):
c = text[i]
if in_str:
out.append(c)
if c == "\\" and i + 1 < len(text):
out.append(text[i + 1]); i += 2; continue
if c == '"':
in_str = False
elif c == '"':
in_str = True; out.append(c)
elif text.startswith("//", i):
while i < len(text) and text[i] != "\n":
i += 1
continue
elif text.startswith("/*", i):
end = text.find("*/", i + 2)
i = len(text) if end == -1 else end + 2
continue
else:
out.append(c)
i += 1
cleaned = re.sub(r",(\s*[}\]])", r"\1", "".join(out)) # 末尾カンマを外す
return json.loads(cleaned)
def main() -> int:
src = Path(sys.argv[1]).expanduser() if len(sys.argv) > 1 else Path("~/.config/zed/settings.json").expanduser()
servers = load_jsonc(src).get("agent_servers", {})
entry = servers.get("Antigravity")
if not entry:
print(f"Antigravity の登録が見つかりません: {src}"); return 1
command = entry.get("command", "agy")
args = entry.get("args", ["acp"])
env = entry.get("env", {})
abs_cmd = command if command.startswith("/") else shutil.which(command)
warnings = []
if not abs_cmd:
warnings.append(f"{command} が PATH に見つかりません。JetBrains と Xcode には絶対パスが必要です")
abs_cmd = "/absolute/path/to/agy"
if "GEMINI_API_KEY" in env:
warnings.append("env に GEMINI_API_KEY があります。移行先の設定ファイルへは書き写していません")
if "--dangerously-skip-permissions" in args:
warnings.append("--dangerously-skip-permissions が付いています。移行先でも本当に要るか確かめてください")
vscode = {"acp.agents": {"Antigravity": {"command": command, "args": args}}}
jetbrains = {"agent_servers": {"Antigravity": {"command": abs_cmd, "args": args}}}
print("# VS Code(ACP Client 拡張)の settings.json に足す")
print(json.dumps(vscode, ensure_ascii=False, indent=2))
print("\n# JetBrains の ~/.jetbrains/acp.json")
print(json.dumps(jetbrains, ensure_ascii=False, indent=2))
print("\n# Xcode > Settings > Intelligence > Add an Agent")
print(f"Command : {abs_cmd}")
print(f"Arguments: {' '.join(args)}")
for w in warnings:
print(f"\n⚠️ {w}")
return 0
if __name__ == "__main__":
sys.exit(main())コメント付き・末尾カンマ付きのサンプル設定(args に --sandbox、env に GEMINI_API_KEY を入れたもの)で動かすと、出力の最後に次の2行が出ました。
⚠️ agy が PATH に見つかりません。JetBrains と Xcode には絶対パスが必要です
⚠️ env に GEMINI_API_KEY があります。移行先の設定ファイルへは書き写していません
このスクリプトは、あえて二つのことをしません。一つは、API キーを移行先へ書き写さないこと。もう一つは、"type": "custom" を他のエディタへ持ち込まないことです。前者は上で書いた線引きのため、後者は「キー名が同じでも書式は別物」だからです。PATH に agy がない環境では絶対パスの欄がプレースホルダーのまま残るので、which agy の結果で埋めてください。
移したあとに確かめる3つのこと
設定を書き換えたら、エディタごとに次の3つを見ると、取りこぼしに早く気づけます。
- 起動するか。 新しいスレッドで Antigravity を選び、短い質問を一つ送ります。起動しないときは、ターミナルで
agy acp --helpが通るかを見てから、command を絶対パスに替えます。 - 権限の確認が出るか。 ファイルの編集やコマンドの実行で Allow / Deny のカードが出れば、権限ルールが CLI 側から効いています。
--dangerously-skip-permissionsを移行先でも付けるかどうかは、ここで改めて決めます(公式は、サンドボックスか使い捨ての環境に限るよう案内しています)。 - ログが残っているか。 うまくいかないときの手がかりは
~/.gemini/antigravity-cli/log/acp-*.logにあります。エディタごとに分けて見たい場合は、argsに--log-fileで出力先を指定できます。
エディタ側で HTTP の MCP サーバーを設定している場合は、--process-per-session が必要になる点も見落としやすいところです。MCP が見えないときの切り分けは Antigravity の MCP がつながらないときの確かめ方 にまとめています。
エディタは増やしても、エージェントは一つにしておく
個人開発でエディタを使い分けていると、それぞれに設定が散らばり、どれが正しいのか分からなくなる日が来ます。ACP のよいところは、エージェントの中身が Antigravity CLI に一本化されていて、エディタは「窓」にすぎない点なのだと思います。
その窓ごとに違うのは、設定の置き場所、コマンドのパス、そして認証とモデルの3つだけです。まずはいま使っている Zed の settings.json を上のスクリプトに通し、⚠️ が出た行から一つずつ片づけていただければと思います。