Antigravity で dev-orchestra を使ってみた I tried dev-orchestra in Antigravity

はじめに

前回は Codex、その前は Claude Code で dev-orchestra を使ってみました。 今回は Google の Antigravity です。

先に結論を書いておきます。

• Antigravity から dev-orchestra に話しかけるのは、普通にできる
• ただし、Antigravity CLI（agy）に設計やレビューを任せるのは限定的
• おすすめは、Antigravity で話しかけて、作業は Claude や Codex に任せる使い方

dev-orchestra が何をするものかは、紹介の記事にまとめています。

dev-orchestra は GitHub で公開しています（MIT ライセンス）。役に立ちそうと思ったら、スターを付けてもらえるとうれしいです。

→ github.com/istb16/dev-orchestra

できること・できないこと

期待外れにならないよう、最初にまとめておきます。

	対応	メモ
Antigravity から dev-orchestra を使う	○	プラグインとして入れれば、話しかけるだけで動く
作業を Claude / Codex に任せる	○	入っていれば自動でそちらに割り振られる
agy に実装・修正を任せる	○	テストを走らせるには設定が要る
agy に設計・レビューを任せる	△	読み取り専用を強制できないので、警告付きの限定対応
Marketplace から入れる	×	クローンしてリンクで入れる

ここで出てくる 2 つの名前を、先に整理しておきます。

• Antigravity: 話しかけるアプリ。dev-orchestra はここにプラグインとして入る
• agy: Antigravity の CLI。dev-orchestra が設計・実装・レビューを割り振る相手の 1 つ

「話しかける場所」と「作業する AI」は別物で、制限があるのは後者として agy を使うときだけです。

必要なもの

もの	メモ
Antigravity	サインインまで済ませておく
Python 3.11 以上	標準ライブラリだけで動く
git	クローンと、レビューする差分を取るのに使う
Claude Code か Codex	なくても動くが、あると作業をそちらに任せられる（おすすめ）

手順

1. インストールする

Antigravity の Marketplace は Google が選んで載せるもので、自分で追加できません。そこで、リポジトリをクローンして、Antigravity のプラグインのフォルダにリンクします。

git clone https://github.com/istb16/dev-orchestra.git
cd dev-orchestra
git checkout v1.0.0
./install/install.sh --antigravity

Windows の PowerShell では、最後の行をこうします。

.\install\install.ps1 -Antigravity

入れたあとは、Antigravity を再起動してください。新しいプラグインは起動したときにしか読み込まれません。

リンクで入れると、クローンしたフォルダの中身がそのまま読み込まれます。なので、リリースのタグ（v1.0.0）を checkout してから入れるのがおすすめです。フォルダの中身を変えたくないときは、--copy（Windows は -Copy）でコピーとして入れることもできます。 Windows ではジャンクションを作るので、開発者モードは要りません。

2. 初回にプリセットを選ぶ

ここからは Claude Code や Codex のときと同じです。dev-orchestra を使う依頼を初めて出すと、プリセットを聞いてきます。 迷ったら standard で大丈夫です。

3. Claude Code も入っているとき（おすすめ）

Antigravity と同じマシンに Claude Code も入っていると、構成はこうなりました（dev-orchestra 1.0.0 の config show の抜粋）。

Preset: standard (implicit; fitted to claude, agy)

  Architect
    claude / fable / latest
  Implementer
    claude / opus / latest
  Reviews
    1. claude / opus / latest / general / claude-general
    2. claude / sonnet / latest / general / claude-general-2
    3. claude / sonnet / latest / security / claude-security (opus when high-risk)
    4. claude / sonnet / latest / test / claude-test

agy はどの役にも入っていません。設計も実装もレビューも Claude です。

これが、いちばんおすすめの形です。

• 話しかけるのは Antigravity（いつもの画面のまま）
• 作業するのは Claude（読み取り専用をきちんと強制できる）

Codex も入っていれば、前回と同じように、レビューに Codex も加わります。

4. agy しか入っていないとき

Claude Code も Codex も入っていないと、すべての役が agy になります。そのときの構成はこうでした（抜粋）。

Preset: standard (implicit; fitted to agy)
  note: claude, codex not found on PATH: architect went to agy (default); agy cannot be held to reading -- set architect in the global file to keep it off agy
  note: claude, codex not found on PATH: reviewer seat 2 (general) was not added; it would repeat agy-general
  note: claude, codex not found on PATH: reviewer seat 3 (security) was not added; agy cannot be held to reading
  note: claude, codex not found on PATH: reviewer seat 4 (test) was not added; agy has no cheap model named offline

  Architect
    agy / default / latest
  Implementer
    agy / default / latest
  Reviews
    1. agy / default / latest / general / agy-general

注目してほしいのは 2 点です。

• レビュアーは 1 人だけ。2 人目の general は 1 人目と同じ agy になるので追加されない。security の枠は「読み取り専用を強制できない」ので置かない。test の枠も、agy には安いモデルを名前で指定できないので追加されない
• 設計やレビューを agy に割り当てた行には、agy cannot be held to reading（読み取り専用を守らせられない）という警告が付く

動くことは動きますが、dev-orchestra のよさ（別の AI が、書き換えずに読んでレビューする）はかなり薄れます。 agy だけの環境なら、Claude Code か Codex を足すことをおすすめします。

5. 準備ができているか確かめる

エージェントに「dev-orchestra の doctor を実行して」と頼みます。agy の部分はこう出ました（抜粋）。

Antigravity CLI (agy)
  Installed: yes
  Model selection: supported
  Read-only runs: NOT ENFORCED (runs allowed, warned) -- agy cannot be held to reading only: ...
  Resume: NOT SUPPORTED -- agy does not resume sessions

NOT ENFORCED は、agy に設計やレビューをさせると、ファイルを書き換えられる状態で動くという意味です。dev-orchestra はそれを止められないので、警告を出したうえで動かします。

最後に No problems found. と出れば準備完了です。

6. 1 文で依頼する

あとは、ほかの環境と同じように話しかけるだけです。

この issue を設定済みのワークフローで実装して

計画の承認から最終報告までの流れは、Claude Code の回に書いたとおりです。

Antigravity の場合だけの機能・制限

agy を作業役として使うときに知っておく点です（dev-orchestra 1.0.0 時点。くわしくは providers.md）。

	内容
△ 設計・レビューで読み取り専用を強制できない	作業ツリーや .ai/（承認の記録も含む）を書き換えられる状態で動く。グローバル設定からだけ、警告付きで受け付ける
△ 実装役は、そのままではテストを走らせられない	シェルコマンドが拒否される。グローバル設定で options.skip_permissions: true にすると走る（下の注意を参照）
× 設計の続きから再開できない	計画を直すときも、毎回新しく実行する
△ 止まったエージェントに気づくのが遅い	ほかの CLI と違い、無反応を見張る期限がない。全体の制限時間に達するまで待つ
△ 1 回の実行でトークンが多め	小さな依頼でも、入力が 1.2 万〜2.5 万トークンほどかかる
○ モデルは agy に任せるか、系列名で指定	既定は default（agy が選ぶ）。gemini-flash / gemini-pro などの系列名でも指定できる
△ 入れ方と更新が手作業	リンクで入れ、入れたあと・更新したあとは Antigravity を再起動する

options.skip_permissions: true にすると、agy に --dangerously-skip-permissions が付きます。テストのコマンドだけでなく、すべてのシェルコマンドで agy の許可の確認を飛ばします。分かったうえでオンにしてください。

agy が読んだファイルの中身は Google に送られます。読み取り専用も強制できないので、.env のような秘密のファイルも読める状態です。秘密のファイルは手の届かない場所に置いておくか、そういうコードはローカルの LLM でレビューするのが安心です（紹介の記事で触れています）。

サインインしているかどうかは、dev-orchestra からは確かめられません。agy の実行が失敗するときは、一度 agy を起動してサインインしてみてください。

まとめ

• Antigravity には、クローンしてリンクで入れる（入れたら再起動）
• 話しかける場所としては普通に使える。いつもの画面のまま dev-orchestra を動かせる
• Claude Code か Codex も入っていれば、作業はそちらに自動で割り振られる。これがおすすめ
• agy に設計やレビューを任せるのは限定的。読み取り専用を強制できないため、警告付きになる
• agy だけの環境では、Claude Code か Codex を足すと dev-orchestra のよさが活きる

詳しい使い方は README（日本語） にまとめています。 ここまでで、3 つの環境での使い方は一通りです。次回からは、プリセットやレビュアーの組み方など、設定の話に入ります。

GitHub: istb16/dev-orchestra（スターを付けてもらえると励みになります）

---

English version

Introduction

Last time I used dev-orchestra with Codex, and before that with Claude Code. This time it’s Google’s Antigravity.

Here’s the conclusion up front.

• Talking to dev-orchestra from Antigravity works just fine
• However, handing design and review to the Antigravity CLI (agy) is limited
• What I recommend: talk to it in Antigravity, and let Claude or Codex do the work

I covered what dev-orchestra does in the introduction post.

dev-orchestra is open source on GitHub (MIT license). If it looks useful, a star would mean a lot.

→ github.com/istb16/dev-orchestra

What works and what doesn’t

To avoid disappointment, here’s the summary first.

	Support	Notes
Use dev-orchestra from Antigravity	Yes	Install it as a plugin and it runs when you ask
Hand the work to Claude / Codex	Yes	If they’re installed, work is assigned to them automatically
Let agy implement and fix	Yes	Running tests needs a setting
Let agy design and review	Partly	Read-only cannot be enforced, so it’s limited support with a warning
Install from the Marketplace	No	Clone and install via a link

Let me sort out the two names that come up here.

• Antigravity: the app you talk to. dev-orchestra goes in here as a plugin
• agy: Antigravity’s CLI. One of the agents dev-orchestra assigns design, implementation, and review to

“The place you talk to” and “the AI that does the work” are different things, and the limits only apply when you use agy as the latter.

What you need

Item	Notes
Antigravity	Already signed in
Python 3.11 or later	Runs on the standard library only
git	Used for cloning and for getting the diff to review
Claude Code or Codex	Not required, but if present the work can be handed to them (recommended)

Steps

1. Install

The Antigravity Marketplace is curated by Google, and you can’t add to it yourself. So instead, clone the repository and link it into Antigravity’s plugin folder.

git clone https://github.com/istb16/dev-orchestra.git
cd dev-orchestra
git checkout v1.0.0
./install/install.sh --antigravity

In Windows PowerShell, the last line becomes this.

.\install\install.ps1 -Antigravity

After installing, restart Antigravity. New plugins are only loaded at startup.

When installed via a link, the contents of the cloned folder are loaded as is. That’s why I recommend checking out the release tag (v1.0.0) before installing. If you don’t want the folder’s contents to change, you can install it as a copy with --copy (-Copy on Windows). On Windows it creates a junction, so Developer Mode isn’t needed.

2. Pick a preset the first time

From here it’s the same as with Claude Code and Codex. The first time you make a request that uses dev-orchestra, it asks you for a preset. If unsure, standard is fine.

3. When Claude Code is also installed (recommended)

With Claude Code also installed on the same machine as Antigravity, the configuration came out like this (excerpt of config show in dev-orchestra 1.0.0).

Preset: standard (implicit; fitted to claude, agy)

  Architect
    claude / fable / latest
  Implementer
    claude / opus / latest
  Reviews
    1. claude / opus / latest / general / claude-general
    2. claude / sonnet / latest / general / claude-general-2
    3. claude / sonnet / latest / security / claude-security (opus when high-risk)
    4. claude / sonnet / latest / test / claude-test

agy has no role at all. Design, implementation, and review are all Claude.

This is the setup I recommend most.

• You talk to Antigravity (your usual screen)
• Claude does the work (read-only can be properly enforced)

If Codex is also installed, Codex joins the reviews too, just like last time.

4. When only agy is installed

If neither Claude Code nor Codex is installed, every role goes to agy. The configuration then looked like this (excerpt).

Preset: standard (implicit; fitted to agy)
  note: claude, codex not found on PATH: architect went to agy (default); agy cannot be held to reading -- set architect in the global file to keep it off agy
  note: claude, codex not found on PATH: reviewer seat 2 (general) was not added; it would repeat agy-general
  note: claude, codex not found on PATH: reviewer seat 3 (security) was not added; agy cannot be held to reading
  note: claude, codex not found on PATH: reviewer seat 4 (test) was not added; agy has no cheap model named offline

  Architect
    agy / default / latest
  Implementer
    agy / default / latest
  Reviews
    1. agy / default / latest / general / agy-general

Two things to note.

• There’s only one reviewer. A second general reviewer would be the same agy as the first, so it isn’t added. The security seat isn’t filled because read-only can’t be enforced. The test seat isn’t added either, since agy has no cheap model you can specify by name
• Lines that assign design or review to agy carry the warning agy cannot be held to reading

It does work, but much of what makes dev-orchestra good (a different AI reading and reviewing without rewriting anything) is lost. If agy is all you have, I recommend adding Claude Code or Codex.

5. Check that everything is ready

Ask the agent “Run the dev-orchestra doctor”. The agy part came out like this (excerpt).

Antigravity CLI (agy)
  Installed: yes
  Model selection: supported
  Read-only runs: NOT ENFORCED (runs allowed, warned) -- agy cannot be held to reading only: ...
  Resume: NOT SUPPORTED -- agy does not resume sessions

NOT ENFORCED means that when agy does design or review, it runs in a state where it can modify files. dev-orchestra can’t stop that, so it runs with a warning.

If it ends with No problems found., you’re ready.

6. Make the request in one sentence

From here, you just talk to it like in any other environment.

Implement this issue with the configured workflow

The flow from plan approval to the final report is as I described in the Claude Code post.

Antigravity-specific features and limits

Things to know when using agy as a worker (as of dev-orchestra 1.0.0; see providers.md for details).

	Details
Caveat: read-only can’t be enforced for design and review	It runs able to modify the working tree and .ai/ (including approval records). Accepted only from the global config, with a warning
Caveat: as implementer, it can’t run tests out of the box	Shell commands are refused. Setting options.skip_permissions: true in the global config lets them run (see the note below)
Not available: can’t resume from where design left off	Even when revising the plan, it runs fresh every time
Caveat: slow to notice a stalled agent	Unlike the other CLIs, there’s no inactivity timeout. It waits until the overall time limit is reached
Caveat: heavy token use per run	Even a small request takes roughly 12,000–25,000 input tokens
Plus: leave the model to agy, or specify it by family name	Default is default (agy chooses). You can also specify a family name like gemini-flash / gemini-pro
Caveat: installing and updating are manual	Install via a link, and restart Antigravity after installing or updating

Setting options.skip_permissions: true adds --dangerously-skip-permissions to agy. It skips agy’s permission prompts for every shell command, not just test commands. Only turn it on if you understand that.

The contents of files agy reads are sent to Google. Since read-only can’t be enforced either, it can read secret files like .env. It’s safer to keep secret files out of reach, or to review such code with a local LLM (I touched on this in the introduction post).

dev-orchestra can’t check whether you’re signed in. If agy runs fail, try launching agy once and signing in.

Summary

• Install into Antigravity by cloning and linking (restart after installing)
• It works fine as the place you talk to. You can run dev-orchestra from your usual screen
• If Claude Code or Codex is also installed, the work is automatically assigned to them. This is what I recommend
• Handing design and review to agy is limited. Read-only can’t be enforced, so it comes with a warning
• If agy is all you have, adding Claude Code or Codex brings out what makes dev-orchestra good

Detailed usage is in the README. That covers usage in all three environments. From the next post on, I’ll get into configuration, such as presets and how to set up reviewers.

GitHub: istb16/dev-orchestra (a star is always appreciated)