dev-orchestra をアップデートしてみた（Claude Code / Codex / Antigravity）

はじめに

前回は、dev-orchestra に自作のエージェントを繋ぎました。今回は、dev-orchestra を新しい版に更新する方法です。

dev-orchestra は 1.0.0 のあと、1.1.0 と 1.1.1 を出しました。更新の方法は、使っている CLI ごとに違います。そこで、1.0.0 を入れた状態から 1.1.1 に上げるところを、Claude Code・Codex・Antigravity のそれぞれで実際に試しました。

試すときは、普段使っている設定とは別のフォルダを用意して、そこに 1.0.0 を入れてから更新しています（Claude Code は CLAUDE_CONFIG_DIR、Codex は CODEX_HOME を作業用のフォルダに向けました）。

• Windows 11
• Claude Code 2.1.301
• Codex CLI 0.163.0
• Antigravity CLI（agy）1.3.6

外し方は、あとからアンインストールの節に足しました（2026-10-29）。こちらは 1.3.0 を同じように別のフォルダに入れてから、実際に外して確かめています。

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

→ github.com/istb16/dev-orchestra

先に結論

CLI	更新のしかた	反映
Claude Code	claude plugin marketplace update dev-orchestra → claude plugin update dev-orchestra	Claude Code を再起動
Codex	codex plugin marketplace upgrade dev-orchestra → codex plugin add dev-orchestra@dev-orchestra	新しいセッションから
Antigravity（リンクで入れた）	チェックアウトで git fetch --tags → git checkout <新しい版のタグ>（今回は v1.1.1）	Antigravity を再起動
Antigravity（コピーで入れた）	同じくタグを切り替えたあと、入れたときと同じコマンドをもう一度	Antigravity を再起動

いちばん引っかかりやすいのは Claude Code です。claude plugin update だけでは更新されませんでした。

外すときの表は、アンインストールの節にあります。

更新の手順

1. 今の版を確かめる

どの CLI も、入っているプラグインの一覧で版が分かります。

claude plugin list
codex plugin list
agy plugin list

Claude Code ではこう出ます（抜粋）。

  ❯ dev-orchestra@dev-orchestra
    Version: 1.0.0
    Scope: user

最新の版は GitHub のリリースか CHANGELOG で確かめられます。

2. Claude Code：マーケットプレイスを更新してから、プラグインを更新する

ヘルプには、claude plugin update は「最新の版に更新する（反映には再起動が必要）」とあります。そこで、まずこれだけを実行してみました。

$ claude plugin update dev-orchestra
Checking for updates for plugin "dev-orchestra"…
✔ dev-orchestra is already at the latest version (1.0.0).

「すでに最新（1.0.0）」と言われて、更新されません。 Claude Code が手元に持っているマーケットプレイスの情報が古いままなので、1.1.1 が出ていることを知らないためです。

先にマーケットプレイスを更新すると、今度は更新されました。

$ claude plugin marketplace update dev-orchestra
✔ Successfully updated marketplace: dev-orchestra

$ claude plugin update dev-orchestra
Checking for updates for plugin "dev-orchestra"…
✔ Plugin "dev-orchestra" updated from 1.0.0 to 1.1.1 for scope user. Restart to apply changes.

なお、claude plugin marketplace update だけを実行した時点では、claude plugin list の版は 1.0.0 のままでした。2 つとも必要です。

最後に表示されるとおり、Claude Code を再起動すると新しい版が使われます。

Claude Code のセッションの中から /plugin で操作することもできますが、今回試したのはターミナルから実行するコマンドだけです。

3. Codex：スナップショットを取り直して、プラグインを入れ直す

Codex は、マーケットプレイスをスナップショットとして手元に持っています。まずそれを取り直します。

$ codex plugin marketplace upgrade dev-orchestra
Upgraded marketplace `dev-orchestra` to the latest configured revision.

続けて、入れたときと同じコマンドをもう一度実行します。

$ codex plugin add dev-orchestra@dev-orchestra
Added plugin `dev-orchestra` from marketplace `dev-orchestra`.

$ codex plugin list
dev-orchestra@dev-orchestra  installed, enabled  1.1.1  ...

今回の Codex 0.163.0 では、upgrade を実行した時点で 1.1.1 に入れ替わっていました。ただ、Codex の回を書いたときは upgrade だけでは新しい版が入らなかったので、plugin add まで実行しておくのが確実です。もう一度実行しても問題はありません。

新しい版は、次に始めるセッションから使われます。

4. Antigravity：入れ方によって違う

Antigravity は、plugins/ フォルダに置いたディレクトリを読み込みます。そのため、どう置いたかで更新のしかたが変わります。

リンクで入れた場合

リポジトリのチェックアウトを install.sh --antigravity（Windows は install.ps1 -Antigravity）でリンクした場合は、チェックアウトを新しい版のタグに切り替えるだけです。Antigravity の回ではタグ（v1.0.0）を checkout して入れたので、新しい版のタグ（ここでは v1.1.1）に切り替えます。

cd dev-orchestra
git fetch --tags
git checkout v1.1.1

ブランチ（main）を追いかけているチェックアウトなら、git pull でもかまいません。

Windows の PowerShell 版のインストーラは、リンクの代わりにジャンクションを作ります。チェックアウトを 1.0.0 から 1.1.1 に切り替えると、ジャンクションの先にある plugin.json の版も、そのまま 1.0.0 から 1.1.1 に変わりました。macOS / Linux のシンボリックリンクの場合は、今回は試していません（試したのは Windows のジャンクションだけです）。

そのあと Antigravity を再起動します。

コピーで入れた場合

次の入れ方をした場合は、コピーが置かれています。

• install.sh --antigravity --copy
• install.ps1 -Antigravity -Copy
• agy plugin install <チェックアウトのパス>
• Windows の Git Bash から install.sh --antigravity を実行した（Git Bash の ln -s はリンクではなくコピーを作ります）

コピーはチェックアウトを切り替えても変わりません。リンクの場合と同じくタグを切り替えたあと、入れたときと同じコマンドをもう一度実行します。

git fetch --tags
git checkout v1.1.1
./install/install.sh --antigravity --copy

Windows の PowerShell で入れた場合は、こうなります。

git fetch --tags
git checkout v1.1.1
.\install\install.ps1 -Antigravity -Copy

インストーラは前のコピーを置き換えます。

Replaced the existing install at .../.gemini/config/plugins/dev-orchestra
Copied the plugin to .../.gemini/config/plugins/dev-orchestra
Re-run this installer after `git pull` to upgrade.

メッセージには git pull とありますが、タグを checkout しているチェックアウトでは、git pull の代わりに上のようにタグを切り替えます。

agy plugin install <パス> で入れた場合も、もう一度実行すると agy plugin list の版が 1.0.0 から 1.1.1 に変わりました。どちらの場合も、最後に Antigravity を再起動します。

インストーラで入れていて、自分がどちらで入れたか分からないときは、~/.gemini/config/plugins/dev-orchestra がリンク（Windows ではジャンクション）かどうかを見てください。ふつうのフォルダなら、コピーです。agy plugin install で入れた場合は、いつもコピーです（試した agy 1.3.6 では別の場所に置かれましたが、1.4.10 では同じ ~/.gemini/config/plugins/dev-orchestra に置かれました。外すときの見分け方はアンインストールの節にあります）。

5. チェックアウトから導入した場合

CLI のプラグインの仕組みを通さず、チェックアウトから直接入れている場合も、考え方は同じです。README の「アップグレード」には、チェックアウトから入れたなら git pull で更新するとあります。タグを checkout しているなら、上と同じようにタグを切り替えます。--copy で入れたなら、そのあとインストーラをもう一度実行します（references/workflow.md の「Installing from a skill checkout」）。この入れ方は、今回は試していません。

6. 更新したあとに確かめること

dev-orchestra doctor を一度実行します（Claude Code などに「dev-orchestra の doctor を実行して」と頼んでも同じです）。CLI、設定、モデルが今の版でも問題ないかを確かめられます。No problems found. と出れば大丈夫ですが、その下に注意が出ることもあるので、あわせて読んでください。下の例のように、設定が無視されたという注意が出ることがあります。

試した環境では、こんな違いが出ました。設定ファイルに、1.1.0 で増えた design.ask_questions を先に書いていたためです。1.0.0 の doctor では知らない設定として注意が出ていましたが、1.1.1 では消えました。

== 1.0.0
No problems found.
  - design.ask_questions in the global file: unknown key, ignored
== 1.1.1
No problems found.

あわせて、次のことも知っておくと安心です。

• 設定と自作のアダプタは消えません。 設定（config.yaml）と自作のアダプタ（<設定ディレクトリ>/providers/）は、プラグインの外の設定ディレクトリにあります。プラグインを更新しても、そのまま残ります
• CHANGELOG を一度見ておきます。 設定、成果物、コマンドは、メジャーバージョンが同じあいだは互換を保つ方針です。対応が必要な変更があれば CHANGELOG に書いてあります
• 新しい機能は、たいてい自分で有効にするまで動きません。 たとえば 1.1.0 で入った「設計の前に質問する」機能（design.ask_questions）は、初めは無効です。更新しただけでは、今までの動き方は変わりません

アンインストール

入れる・更新するに続けて、外し方もまとめておきます。ここは 2026-10-29 に足した節で、更新の手順とは別に、次の環境で試しました。

• Windows 11
• dev-orchestra 1.3.0
• Claude Code 2.1.312
• Codex CLI 0.163.0
• Antigravity CLI（agy）1.4.10

更新のときと同じく、普段の設定とは別のフォルダに 1.3.0 を入れてから外しています。Claude Code は CLAUDE_CONFIG_DIR、Codex は CODEX_HOME、dev-orchestra の設定は DEV_ORCHESTRA_HOME を作業用のフォルダに向けました。Antigravity はホームのフォルダの下（~/.gemini/config/plugins/）を読むので、USERPROFILE（Git Bash では HOME）を作業用のフォルダに向けて試しています。

CLI / 入れ方	外し方	そのあと
Claude Code	claude plugin uninstall dev-orchestra	念のため Claude Code を再起動
Codex	codex plugin remove dev-orchestra@dev-orchestra	念のため新しいセッションを始める
Antigravity（インストーラで入れた）	./install/uninstall.sh --antigravity（Windows は .\install\uninstall.ps1 -Antigravity）	Antigravity を再起動
Antigravity（agy plugin install で入れた）	agy plugin uninstall dev-orchestra	Antigravity を再起動
チェックアウトから導入した	./install/uninstall.sh（Codex の分は --codex を付ける。Windows は .\install\uninstall.ps1、Codex の分は -Codex）

どの CLI でも、プラグインを外す前に、返答の言語のフックを外し、消したい設定を消しておきます（下の 1.）。dev-orchestra のコマンドは、プラグインと一緒になくなるためです。

1. プラグインを外す前に：フックと設定

返答の言語のフックを外す

language.reply を設定したか dev-orchestra hooks install を実行したなら、Claude Code の設定（settings.json）に dev-orchestra のフックが入っています。これはプラグインを外しても残ります。試しに、フックを入れたまま claude plugin uninstall dev-orchestra だけを実行すると、settings.json には 3 つのフックがそのまま残り、フックが呼ぶ中継のスクリプトも dev-orchestra の設定ディレクトリの hooks/ に残っていました。

そのため、dev-orchestra のコマンドが使えるうちに、先に外します（Claude Code などに「dev-orchestra のフックを外して」と頼んでも同じです）。

$ dev-orchestra hooks uninstall
Removed the reply-language hooks from ...\settings.json
  - UserPromptSubmit: ...
  - SessionStart: ...
  - Stop: ...
  deleted: ...\hooks\dev_orchestra_hook.py
  deleted: ...\hooks\plugin.json
  previous file kept as ...\settings.json.dev-orchestra-backup

外す前の settings.json は、settings.json.dev-orchestra-backup として残ります。フックを入れていない場合は、この手順は要りません（dev-orchestra hooks status で Status: not-installed と出ます）。

設定も消すなら、ここで消す

もう dev-orchestra を使わず、設定も消すなら、このときに消しておきます。

$ dev-orchestra config reset --scope global --delete
Removed ...\dev-orchestra\config.yaml

プロジェクトごとの設定（.dev-orchestra.yaml）を作っていたなら、そのプロジェクトのフォルダで --scope project を付けて実行すると、そのファイルが消えます。

$ dev-orchestra config reset --scope project --delete
Removed ...\.dev-orchestra.yaml

どちらも消えるのは設定のファイルだけです。ほかに残るものは、下の 6. にまとめました。

2. Claude Code

$ claude plugin uninstall dev-orchestra
✔ Successfully uninstalled plugin: dev-orchestra (scope: user)

claude plugin list から消え、settings.json の enabledPlugins からも外れました。更新のときと違い、出力に再起動の案内（Restart to apply changes.）は出ませんでした。動いている Claude Code のセッションにすぐ反映されるかは試していないので、念のため再起動しておくと確実です。

マーケットプレイスの登録は残ります。もう使わないなら、こちらも外します。

$ claude plugin marketplace remove dev-orchestra
✔ Successfully removed marketplace: dev-orchestra

なお、プラグインの中身のコピー（~/.claude/plugins/cache/dev-orchestra/ の下）は、外した直後には消えず、.orphaned_at という印のファイルが置かれた状態で残っていました。

3. Codex

$ codex plugin remove dev-orchestra@dev-orchestra
Removed plugin `dev-orchestra` from marketplace `dev-orchestra`.

codex plugin list では not installed になります。マーケットプレイスは登録されたままなので、もう使わないなら外します。

$ codex plugin marketplace remove dev-orchestra
Removed marketplace `dev-orchestra`.
Removed installed marketplace root: ...\.tmp\marketplaces\dev-orchestra

マーケットプレイスを外すと、手元のスナップショットも一緒に消えました。

動いている Codex のセッションにすぐ反映されるかは試していないので、念のため新しいセッションを始めておくと確実です。

4. Antigravity：入れ方によって違う

更新のときと同じく、どう入れたかで外し方が変わります。

インストーラで入れた場合

install.sh --antigravity / install.ps1 -Antigravity で入れたなら、リンクでもコピーでも、チェックアウトで同じフラグのアンインストーラを実行します。

.\install\uninstall.ps1 -Antigravity

Removed ...\.gemini\config\plugins\dev-orchestra
Restart Antigravity so that it stops loading the plugin.
The checkout at ...\dev-orchestra was left in place.

macOS / Linux や Git Bash では ./install/uninstall.sh --antigravity です（Git Bash でコピーを入れて外すところまで試しました）。アンインストーラが消すのは plugins/ の下のリンクやコピーだけで、チェックアウトそのものは残ります。

試した agy 1.4.10 では、コピーで入れた場合は agy plugin list に dev-orchestra (enabled, 1.3.0) と出て、外したあとは No plugins installed. になりました。リンク（Windows ではジャンクション）で入れた場合は、外す前から agy plugin list に出なかったので、plugins/ の下のジャンクションがなくなったことで確かめました。

agy plugin install で入れた場合

agy plugin install <チェックアウトのパス> で入れたなら、agy で外します。

$ agy plugin uninstall dev-orchestra
Uninstalled plugin "dev-orchestra"

試した agy 1.4.10 では、agy plugin install も同じ ~/.gemini/config/plugins/dev-orchestra にコピーを置きました。ただ、インストーラが書いたものではないので、uninstall.sh --antigravity は消さずに残します。

.../.gemini/config/plugins/dev-orchestra exists and the installer did not write it; it was left in place.
Remove it by hand if it is no longer wanted.

この表示が出たら、agy plugin uninstall dev-orchestra を使ってください。

再起動について（試していないこと）

README には、外したあと Antigravity を再起動するとあります。アンインストーラも最後に Restart Antigravity so that it stops loading the plugin. と表示します。今回確かめたのは agy plugin list とフォルダまでで、動いている Antigravity が再起動のあとに読み込まなくなるところは試していません。README の手順どおり、外したら再起動してください。

5. チェックアウトから導入した場合

CLI のプラグインの仕組みを通さず、チェックアウトのインストーラで入れた場合は、同じチェックアウトのアンインストーラで外します。

$ ./install/uninstall.sh
Removed .../skills/dev-orchestra
The checkout at .../dev-orchestra was left in place.

$ ./install/uninstall.sh --codex
Removed the pointer block from .../AGENTS.md

1 つめは Claude Code のスキル（~/.claude/skills/dev-orchestra）を、2 つめは Codex の AGENTS.md に足した案内のブロックだけを消します。AGENTS.md のほかの部分は残ります。試したのは Git Bash の uninstall.sh で、Windows の uninstall.ps1 はこの入れ方では試していません。

6. 外したあとに残るもの

プラグインを外しても、次のものは残ります。もう使わないなら、自分で消します。

• 設定：設定ディレクトリの config.yaml と、プロジェクトごとの .dev-orchestra.yaml。消し方は上の 1. のとおりです。プラグインを外したあとなら、ファイルを手で消します
• 自作のアダプタ：<設定ディレクトリ>/providers/。config reset --delete が消すのは config.yaml だけで、providers/ はそのまま残りました
• 成果物：プロジェクトごとの .ai/。dev-orchestra を使ったプロジェクトごとに、要らなければ消します

設定ディレクトリは、Windows では %APPDATA%\dev-orchestra\、macOS では ~/.config/dev-orchestra/、Linux では $XDG_CONFIG_HOME/dev-orchestra/（なければ ~/.config/dev-orchestra/）です。DEV_ORCHESTRA_HOME を設定しているなら、そのフォルダです。

まとめた手順は、README の「アンインストール」にもあります。

まとめ

• 今の版は claude plugin list / codex plugin list / agy plugin list で分かる
• Claude Code は claude plugin marketplace update dev-orchestra → claude plugin update dev-orchestra → 再起動。plugin update だけでは「最新」と言われて更新されない
• Codex は codex plugin marketplace upgrade dev-orchestra → codex plugin add dev-orchestra@dev-orchestra。新しいセッションから使われる
• Antigravity は、リンクならチェックアウトを新しい版のタグに切り替える（git fetch --tags → git checkout <新しい版のタグ>。今回は v1.1.1。ブランチを追いかけているなら git pull）。コピーなら、そのあと入れたときのコマンドをもう一度。どちらも再起動
• 更新したら doctor を一度。設定と自作のアダプタは消えない
• 外すときは、プラグインを外す前に、返答の言語のフックを入れていれば dev-orchestra hooks uninstall、設定も消すなら dev-orchestra config reset --scope global --delete（プロジェクトの設定は --scope project）。そのあと claude plugin uninstall dev-orchestra / codex plugin remove dev-orchestra@dev-orchestra / Antigravity は入れ方に合わせて uninstall.sh --antigravity か agy plugin uninstall dev-orchestra。消さなければ、設定・自作のアダプタ・.ai/ は残る

次回は、役割ごとに決まった指示を渡す機能を試します。

新しい版を出したときは、この記事の手順で更新してください。

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

この連載の記事は、「dev-orchestra」の一覧でまとめて読めます。

この記事は tk3.biz のブログ からの転載です。