A field-tested integration guide — architecture, full source code, and eleven pitfalls we hit so you don’t have to.

• Components: Hermes Agent (open-source agent runtime) · CodeBuddy Code CLI 2.180.0 (Tencent’s Claude-Code-style coding CLI) · systemd user services
• Scope: Replace an agent’s direct model-API calls with a local, resident CodeBuddy CLI reached over ACP (Agent Client Protocol) — without touching the agent’s core loop.
• Status: Running in production on our side; every command and code block below is verbatim from the working deployment.