Sign InOpen Brain
Back
VercelEngineering PostOfficial SourcetoolsNew

Use ACP-compatible harnesses with the AI SDK harness layer

Use ACP for portable harness integration, but test permissions, events, and runtime-specific controls before replacing a direct adapter.

VercelAug 13, 20262 min
Open SourceOpen MarkdownOpen JSON
Source Summary

A new ACP meta-adapter lets HarnessAgent run compatible runtimes that lack dedicated integrations. Keep direct Claude Code and Codex adapters where tighter behavior matters.

Practical Implication

Use the meta-adapter to connect a compatible harness that has no native AI SDK integration. For Claude Code and Codex, Vercel recommends their dedicated adapters because they can expose runtime behavior more precisely.

Agent-Ready Context
The new **@ai-sdk/harness-acp** package adapts the Agent Client Protocol rather than one runtime. Builders pass an ACP-compatible package to **createACP**, map the harness basics, and use the result with HarnessAgent.

Use the meta-adapter to connect a compatible harness that has no native AI SDK integration. For **Claude Code and Codex**, Vercel recommends their dedicated adapters because they can expose runtime behavior more precisely.

ACP is not universal, and its abstraction may limit or alter access to a harness’s internals. Treat protocol compatibility as a portability option, then test permissions, events, and runtime-specific behavior before replacing a direct adapter.
Context Map
toolscoding#coding-agents#agent-sdks#harness-engineeringGeneric AgentPrepare Coding Session
Rate This Item
Personal Note

No note yet. Notes are included in exported bundles.

Related — Every Edge Explained

No approved edges yet for this post.