Skip to content

fix(agent): support GenericAgent ACP and add setup guide - #442

Closed
Phil-Fan wants to merge 2 commits into
poco-ai:mainfrom
Phil-Fan:main
Closed

fix(agent): support GenericAgent ACP and add setup guide#442
Phil-Fan wants to merge 2 commits into
poco-ai:mainfrom
Phil-Fan:main

Conversation

@Phil-Fan

@Phil-Fan Phil-Fan commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR enables Agentero to connect to GenericAgent via the Agent Client Protocol (ACP), and documents the setup.

GenericAgent ships an experimental ACP stdio bridge (frontends/genericagent_acp_bridge.py). Agentero's ACP client already supports custom agents, but two issues prevented GenericAgent from working out of the box:

  1. Custom agents did not get the cwd shell wrapper, so relative paths in args resolved against an unspecified process cwd (often / when spawned from the GUI), producing errors like //frontends/genericagent_acp_bridge.py: No such file or directory.
  2. There was no documentation for configuring GenericAgent as a custom ACP agent.

What changed

  • fix(agent): include AgentTemplate::Custom in needs_local_cwd_shell_wrap() so custom agents are launched through a cd <vault-cwd> && exec <command> <args> shell wrapper, matching the existing behavior for the Pi adapter.
  • docs(usage): add docs/usage/genericagent-acp.md with step-by-step configuration, verification, tips, and troubleshooting; link it from docs/usage/index.md and docs/usage/agents.md.

Related

Custom agents previously did not get the cwd shell wrapper, so relative
paths in args were resolved against an unspecified process cwd (often /
when spawned from the GUI), causing errors like //frontends/xxx.py not
found. Include AgentTemplate::Custom in needs_local_cwd_shell_wrap() so
custom agents also cd into the vault before exec.
- New guide at docs/usage/genericagent-acp.md covering installation,
  bridge launch, Agentero custom agent configuration, verification,
  usage tips and troubleshooting.
- Link from docs/usage/index.md and docs/usage/agents.md.
@Phil-Fan

Phil-Fan commented Sep 2, 2026

Copy link
Copy Markdown
Contributor Author

Closing — the intended upstream PR is for GenericAgent only. Agentero-side notes and the small cwd-shell fix will stay in the fork for local use.

@Phil-Fan Phil-Fan closed this Sep 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant