Skip to content
AgentZforiMIS®

Connecting your AI app

Connecting your AI app adds the AgentZ plugin to it. The plugin is what lets the AI app do work in your iMIS site through the AgentZ app. AgentZ works with Claude Code (command line), Claude desktop app, Codex, OpenCode, GitHub Copilot, Cursor, Grok Build, Devin and Hermes Agent.

  • An AI app installed on this computer, and signed in to its own account. AgentZ does not provide the AI app or its subscription. If no supported AI app is on the computer, Settings > Overview shows No AI app found for AI app.
  • The AgentZ app open and signed in. The plugin connects to the AgentZ app on the same computer, so the AgentZ app must be running while you use AgentZ in your AI app.
  • Permission to change your AI app’s settings. For some AI apps you type a command in a terminal window (Terminal on a Mac, PowerShell on Windows). The card for that app gives the exact commands.

Go to Settings > AI apps. The tab shows:

  • AgentZ plugin version: the newest AgentZ plugin, whether every app here is up to date, and Update now.
  • Keep the AgentZ plugin up to date automatically: on by default. See Updating AgentZ.
  • One card for each supported AI app, with a badge that says whether it is on this computer and whether AgentZ is in it, for example Up to date or Not found on this computer.

The AI apps tab of Settings, with the AgentZ plugin version, the automatic update switch and the first AI app cardsThe AI apps tab of Settings, with the AgentZ plugin version, the automatic update switch and the first AI app cards

Each card is described in AI apps settings.

AgentZ adds itself to some AI apps, and for others you add it, following the steps on the app’s card.

AI app How AgentZ is added
Claude desktop app (Chat, Cowork and the Code tab) You add it in Claude, from the iFINITY marketplace. See Claude desktop app.
Claude Code (command line) Click Install Plugin on its card.
Codex You run two commands in a terminal, then turn on the Desktop Apps Bridge on its card. See Codex.
OpenCode, GitHub Copilot, Grok Build and Devin AgentZ adds itself with the app’s own command when it finds the app on this computer, unless you have taken it out.
Cursor Cursor uses the AgentZ plugin that Claude Code installed. Install it in Claude Code on this computer.
Hermes Agent Turn on the Desktop Apps Bridge on its card. Hermes Agent has no plugins.

The Claude desktop app keeps its own copy of the AgentZ plugin, which Cowork and the app’s Code tab both use. You add it in Claude.

Do the following to add AgentZ to the Claude desktop app:

  1. In Claude, click Plugins in the sidebar, then Add, then Add marketplace, then Add from a repository.
  2. In URL, enter iFINITY-Ltd/ifinity-marketplace, then click Sync.
  3. In Plugins, search for agentz, choose Agentz, then click Add.
  4. Go back to Plugins, click Add, then Manage marketplaces. Open the … menu on ifinity-marketplace, turn on Sync automatically, then click Done. Claude then fetches new versions of AgentZ for you.
  5. Reopen Claude, so that it starts AgentZ:
    • 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.
    • 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.

In AgentZ, the Claude desktop app card shows Up to date.

If your organisation cannot use the marketplace, the card also offers Download ZIP: in Claude, click Plugins > Add > Upload plugin, and drop the ZIP into the upload panel.

Codex starts AgentZ through the Desktop Apps Bridge, so it needs both the plugin and the bridge.

Do the following to add AgentZ to Codex:

  1. Open a terminal window (Terminal on a Mac, PowerShell on Windows).
  2. Run codex plugin marketplace add iFINITY-Ltd/ifinity-marketplace.
  3. Run codex plugin add agentz@ifinity.
  4. In AgentZ, go to Settings > AI apps and turn on the Desktop Apps Bridge on the Codex card.
  5. Close Codex, including any open sessions, and open it again.

The Codex card shows that AgentZ is installed. AgentZ keeps it up to date when Keep the AgentZ plugin up to date automatically is on.

This is the copy the claude command uses, in a terminal or in an editor such as VS Code. When Claude Code is on this computer, its card shows Install Plugin. Click it, then start a new Claude Code session.

Cursor and Grok Build also use this copy, so installing it gives them AgentZ too. On Windows, Grok Build cannot start AgentZ from this copy: turn on Desktop Apps Bridge on Grok Build’s card in Settings > AI apps.

Go to Settings > Overview. The AI app check shows Ready and names the apps AgentZ works in, for example “AgentZ works in Claude desktop app.”

The Overview's set-up checks, with AI app showing ReadyThe Overview's set-up checks, with AI app showing Ready

Then ask your AI app something about iMIS. See Making your first request.

If the AI app says AgentZ is not connected, or a card says the app was not found, see AI app connection troubleshooting.

Do I need the AgentZ app running to use AgentZ in my AI app? Yes. The plugin works through the AgentZ app on the same computer, which holds your iMIS sign-in.

Can I use AgentZ in more than one AI app? Yes. Add it to each one. Every AI app you use appears in the AgentZ app’s activity.

Can I install the plugin without the AgentZ app? No. The plugin needs the AgentZ app to sign in to iMIS for it.

Why does Claude show the plugin as “Agentz”? That is how the Claude desktop app shows the plugin’s name in its marketplace. It is the AgentZ plugin.