dev-orchestra をアップデートしてみた（Claude Code / Codex / Antigravity） Updating 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

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

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 で入れた場合は、別の場所に置かれ、いつもコピーです。

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）は、初めは無効です。更新しただけでは、今までの動き方は変わりません

まとめ

• 今の版は 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 を一度。設定と自作のアダプタは消えない

これで連載は終わりです。最初から読む場合は、紹介の記事からどうぞ。新しい版を出したときは、この記事の手順で更新してください。

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

---

English version

Introduction

Last time, I connected my own agent to dev-orchestra. The last post in the series is about updating dev-orchestra to a new version.

Since 1.0.0, dev-orchestra has had two releases, 1.1.0 and 1.1.1. How you update depends on the CLI you use. So I actually tried going from 1.0.0 to 1.1.1 in each of Claude Code, Codex, and Antigravity.

For the test, I set up folders separate from my everyday configuration, installed 1.0.0 there, and then updated (I pointed CLAUDE_CONFIG_DIR for Claude Code and CODEX_HOME for Codex at scratch folders).

• Windows 11
• Claude Code 2.1.301
• Codex CLI 0.163.0
• Antigravity CLI (agy) 1.3.6

For what dev-orchestra does, see 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

The short version

CLI	How to update	Takes effect
Claude Code	claude plugin marketplace update dev-orchestra → claude plugin update dev-orchestra	Restart Claude Code
Codex	codex plugin marketplace upgrade dev-orchestra → codex plugin add dev-orchestra@dev-orchestra	From the next session
Antigravity (installed as a link)	git fetch --tags → git checkout <new tag> in the checkout (v1.1.1 this time)	Restart Antigravity
Antigravity (installed as a copy)	Switch the tag the same way, then run the install command again	Restart Antigravity

The one most likely to trip you up is Claude Code: claude plugin update on its own did not update anything.

Steps

1. Check your current version

Every CLI shows the version in its list of installed plugins.

claude plugin list
codex plugin list
agy plugin list

Claude Code shows this (excerpt).

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

You can find the latest version on the GitHub releases page or in the CHANGELOG.

2. Claude Code: refresh the marketplace, then update the plugin

The help says claude plugin update updates a plugin to the latest version (restart required to apply). So first I ran just that.

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

It said it was already at the latest version (1.0.0), and nothing was updated. Claude Code’s local copy of the marketplace was still old, so it didn’t know 1.1.1 existed.

After refreshing the marketplace first, the update went through.

$ 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.

Running only claude plugin marketplace update left the version in claude plugin list at 1.0.0. You need both.

As the last line says, restart Claude Code to start using the new version.

You can also do this from inside a Claude Code session with /plugin, but I only tried the commands you run from the terminal.

3. Codex: refresh the snapshot, then add the plugin again

Codex keeps the marketplace locally as a snapshot. First, refresh it.

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

Then run the same command you used to install it.

$ 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  ...

With Codex 0.163.0 this time, the plugin had already switched to 1.1.1 after upgrade. But when I wrote the Codex post, upgrade alone did not install the new version, so running plugin add as well is the safe choice. Running it again does no harm.

The new version is used from the next session you start.

4. Antigravity: it depends on how you installed it

Antigravity loads the directories placed in its plugins/ folder. So the way to update depends on how it was placed there.

If you installed it as a link

If you linked the repository checkout with install.sh --antigravity (install.ps1 -Antigravity on Windows), just switch the checkout to the new version’s tag. In the Antigravity post (in Japanese), I installed from a checkout of the tag (v1.0.0), so switch to the new version’s tag (v1.1.1 here).

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

If your checkout follows a branch (main), git pull works too.

On Windows, the PowerShell installer creates a junction instead of a link. When I switched the checkout from 1.0.0 to 1.1.1, the version in plugin.json seen through the junction changed from 1.0.0 to 1.1.1 as well. I didn’t try a symlink on macOS / Linux this time (I only tried the Windows junction).

Then restart Antigravity.

If you installed it as a copy

These install methods leave a copy:

• install.sh --antigravity --copy
• install.ps1 -Antigravity -Copy
• agy plugin install <path to the checkout>
• Running install.sh --antigravity from Git Bash on Windows (Git Bash’s ln -s makes a copy, not a link)

A copy doesn’t change when you switch the checkout. Switch the tag as in the link case, then run the same install command again.

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

If you installed from Windows PowerShell, it looks like this.

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

The installer replaces the old 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.

The message says git pull, but for a checkout on a tag, you switch the tag as above instead.

If you installed with agy plugin install <path>, running it again also changed the version in agy plugin list from 1.0.0 to 1.1.1. Either way, finish by restarting Antigravity.

If you used the installer and you’re not sure which way you installed it, check whether ~/.gemini/config/plugins/dev-orchestra is a link (a junction on Windows). If it’s an ordinary folder, it’s a copy. An install made with agy plugin install is placed somewhere else and is always a copy.

5. If you installed from a checkout

If you installed directly from a checkout without going through a CLI’s plugin system, it works the same way. The README’s “Upgrading” section says a checkout install upgrades with git pull. If your checkout is on a tag, switch the tag as above. For an install made with --copy, run the installer again afterwards (references/workflow.md, “Installing from a skill checkout”). I didn’t try this install method this time.

6. What to check after updating

Run dev-orchestra doctor once (asking Claude Code or another agent to “run dev-orchestra’s doctor” works too). It checks that your CLIs, configuration and models are still fine with the new version. If No problems found. appears, you’re good, but read any notes below it too. As in the example below, a note can say a setting was ignored.

In my test environment, this difference showed up. My config file already had design.ask_questions, a setting added in 1.1.0. The 1.0.0 doctor flagged it as an unknown setting, and the note was gone in 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.

These are also good to know:

• Your configuration and your own adapters are kept. The configuration (config.yaml) and your own adapters (<config directory>/providers/) live in the config directory, outside the plugin. They stay as they are when the plugin is updated
• Take a look at the CHANGELOG. Configuration, artifacts and commands stay compatible within a major version. Any change you need to act on is written in the CHANGELOG
• New features usually stay off until you turn them on. For example, the “ask questions before the design” feature added in 1.1.0 (design.ask_questions) is off by default. Updating alone doesn’t change how things have been working

Summary

• Check your version with claude plugin list / codex plugin list / agy plugin list
• Claude Code: claude plugin marketplace update dev-orchestra → claude plugin update dev-orchestra → restart. plugin update alone says “already at the latest version” and does nothing
• Codex: codex plugin marketplace upgrade dev-orchestra → codex plugin add dev-orchestra@dev-orchestra. Used from the next session
• Antigravity: for a link, switch the checkout to the new version’s tag (git fetch --tags → git checkout <new tag>, v1.1.1 this time, or git pull if you follow a branch). For a copy, then run the install command again. Restart either way
• After updating, run doctor once. Your configuration and your own adapters are kept

That’s the end of the series. To read it from the beginning, start with the introduction post. When a new version comes out, update with the steps in this post.

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