Skip to content

Agent Client

What this covers

This page is for setups where Minion Mind hosts an agent client plugin and you want external agents connected through command-line bridges.

Typical setup flow

  1. Install or enable the agent client plugin.
  2. Open its settings page.
  3. Configure the command path for each agent.
  4. Add any required arguments.
  5. Add API keys or other environment variables only when that agent requires them.

Sanity checks

Before debugging the plugin UI, confirm:

  • The command exists on disk.
  • Running the command manually does not immediately crash.
  • The configured arguments are correct for that agent bridge.
  • The vault is trusted and the plugin is enabled.

Common failure modes

The view opens but never connects

  • The bridge command exits immediately instead of waiting on stdio.
  • The arguments are valid for a CLI, but not for ACP-style communication.
  • The plugin saved a stale path.

Settings page does not open

  • The plugin setting tab is not being registered correctly.
  • The host app is missing a compatibility path the plugin expects.

One agent works and another does not

  • Different bridges have different stdio expectations.
  • One agent may tolerate partial host compatibility while another does not.

Minion Mind docs live alongside the release portal.