Plugin update troubleshooting
Use this article when Settings > AI apps, or the AI app check on Settings > Overview, says an AI app’s AgentZ plugin is not up to date. Each heading is what the AI app’s card says. How updates work is described in Updating AgentZ.
Reopen to finish updating
Section titled “Reopen to finish updating”The newest plugin is installed, but the AI app is still running an older one, for example “0.7.43 is installed, but Claude is still running 0.7.41.”, followed by how to reopen Claude on your computer.
Do what the card says. These are the steps for each AI app:
| AI app | What to do |
|---|---|
| Claude desktop app, on a Mac | Quit Claude completely: choose Claude, then Quit Claude (or press Command-Q). Then open Claude again. Closing its window is not enough. |
| Claude desktop app, on Windows | Quit Claude completely: right-click the Claude icon next to the clock (it may be behind the ^ arrow) and choose Exit. Then open Claude again. Closing its window is not enough. |
| Claude Code (command line) | Start a new Claude Code session, or type /reload-plugins in an open one. |
| Codex | Close Codex, including any open sessions, and open it again. |
| OpenCode | Close OpenCode and open it again. |
| GitHub Copilot | Close GitHub Copilot and open it again. |
| Cursor | Close Cursor and open it again. |
| Grok Build | Close Grok Build and open it again. |
| Devin | Close Devin and open it again. |
Closing the Claude desktop app’s window leaves Claude, and the AgentZ plugin it started, running in the background. Reopening it then shows the same Claude, still with the old plugin.
The card changes to Up to date once the old plugin has stopped.
Update available
Section titled “Update available”A newer AgentZ plugin is out than the one in the AI app.
- For Claude Code (command line), Codex, OpenCode, GitHub Copilot, Grok Build and Devin, AgentZ updates the plugin itself when Keep the AgentZ plugin up to date automatically is on. To update now, click Update now at the top of the AI apps tab.
- For the Claude desktop app, Claude updates its own copy. The card says, for example, “0.7.41 is installed and 0.7.43 is out.”, then: In Claude, choose Plugins in the sidebar. Under Your plugins, choose Show all, then Agentz, then Update. If Update is greyed out and shows "On latest version", Claude already has the new version. Then it says how to reopen Claude on your computer.
- For Cursor, update the copy Claude Code installed: Cursor uses it.
To have Claude fetch new versions for you, turn on Sync automatically for the iFINITY marketplace: in Claude’s Plugins, click Add > Manage marketplaces, then the marketplace’s … menu. A new version still starts only once Claude is reopened.
Claude says the plugin could not be updated
Section titled “Claude says the plugin could not be updated”On Windows, Claude may say “Plugin couldn’t be updated. Try again.” when you update AgentZ in Claude’s Plugins, and its copy stays on the older version however often you reopen Claude. Claude cannot replace its copy of AgentZ while it is running the old one, and it starts the old one again each time it opens.
Do the following:
- In AgentZ, go to Settings > AI apps and find the Claude desktop app card.
- Click Let Claude update AgentZ, then Stop the plugin. AgentZ stops only the old AgentZ plugin: Claude stays open, and your conversations and work in Claude are kept. Anything an agent is doing in iMIS through AgentZ in Claude stops.
- In Claude, choose Plugins in the sidebar. Under Your plugins, choose Show all, then Agentz. If Update is offered, click it. If it is greyed out and shows “On latest version”, Claude already has the new version.
- Reopen Claude: Quit Claude completely: right-click the Claude icon next to the clock (it may be behind the ^ arrow) and choose Exit. Then open Claude again. Closing its window is not enough.
The card changes to Up to date. From then on, Claude can update AgentZ by itself.
Update to connect
Section titled “Update to connect”The AI app’s AgentZ plugin is too old to connect to the AgentZ app. The card names the app and the plugin’s version, for example “The Claude desktop app has an older AgentZ plugin (0.7.40) that cannot connect to this app.” The AgentZ plugin line in the sidebar says the same and what to do.
Update the plugin as described under Update available, then reopen the AI app as described under Reopen to finish updating.
Old copy found
Section titled “Old copy found”The newest plugin is installed, but the AI app also holds an older copy of AgentZ and can start that one instead. The card lists the copies.
- Claude desktop app: remove the older copy in Claude: click Plugins in the sidebar, then under Your plugins click Show all, and choose Remove in that copy’s … menu. Leave the entry agentz marked Local dev: it is the AgentZ app’s own connection. If you do not see the older copy there, it belongs to another Claude account or organisation on this computer. Then reopen Claude as described under Reopen to finish updating.
- Any other AI app: remove the older copy the card names, in that app.
Plugin update, on Settings > Overview
Section titled “Plugin update, on Settings > Overview”The AI app check on the Overview tab shows Plugin update and names each AI app that is behind, in a few words:
| The Overview says | It means | See |
|---|---|---|
| app needs reopening | The newest plugin is installed, but the app still runs an older one. | Reopen to finish updating |
| app has version, or app is behind | The app’s plugin is older than the newest one. | Update available |
| app needs an update to connect | The app’s plugin is too old to connect to this AgentZ app. | Update to connect |
| app needs the Desktop Apps Bridge | On Windows, Grok Build starts AgentZ only through the bridge. | AI app connection troubleshooting |
Click Open AI apps on the check to go to the card.
AgentZ needs to restart to finish updating
Section titled “AgentZ needs to restart to finish updating”Some screens wait until a downloaded update of the AgentZ app itself is installed, because the screen needs the new version:
- iMIS sites: “AgentZ needs to restart to finish updating before you can add an iMIS site.”
- BuildHub: “This version of AgentZ does not include BuildHub yet. Restart AgentZ to finish the pending update, then open BuildHub again.”
Restart AgentZ, for example with Update & Restart when the update notice shows it. This is the AgentZ app’s own update, not the plugin’s. See Updating AgentZ.
1 app needs attention, on the AgentZ plugin version card
Section titled “1 app needs attention, on the AgentZ plugin version card”The top of the AI apps tab counts the AI apps whose plugin is not up to date. Scroll to the card that does not say Up to date and follow it.
Do I have to update the plugin myself? For most AI apps, no: AgentZ does it. The Claude desktop app keeps its own copy, which Claude updates when Sync automatically is on, or when you check for updates in Claude.
Why does my AI app still say AgentZ is not connected after an update? It is still running the plugin it started before the update. Reopen it as described under Reopen to finish updating. For the Claude desktop app, closing its window is not enough.

