Built-in catalog
Discovery
Ready means:
- Every binary in
Requiresis onPATH. - If an adapter is required, that binary exists beside
gpr.
Selecting an agent
Set the agent on the workspace in the app. Tasks use that workspace’s agent when claimed.Protocol path
Adding new agents later
New catalog entries ship with daemon releases. Prefer agents that already appear ingpr discover.
When you need a custom ACP binary, extra env (API keys, proxy URLs), or an agent id that is not in the catalog, write agents.json. Names in that file are advertised to the app on connect. A catalog id you redefine fully replaces the built-in launch spec.