pydantic-acp

Wrap ACP-compliant CLI agents as Pydantic AI model providers.

Updated Jul 18, 2026
One-click install
npx skills add https://github.com/arthrod/conejo-skills --skill pydantic-acp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pydantic-acp
Source: https://github.com/arthrod/conejo-skills/tree/main/skills/pydantic-acp
Command: npx skills add https://github.com/arthrod/conejo-skills --skill pydantic-acp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pydantic-ai, pydantic-acp, and includes references (resource) components.

What problem does it solve?

This skill solves the integration gap between Pydantic AI and Agent Client Protocol (ACP) CLI tools, allowing you to use powerful agents like crush or cline as structured model backends while avoiding common pitfalls like JSON-RPC parsing errors and process leaks.

Core Features & Use Cases

  • ACP-to-Pydantic Bridge: Enables the use of ACP-compliant CLI tools as Pydantic AI models, maintaining full control over output validation and history.
  • Host Delegation: Provides a robust interface for managing filesystem, terminal, and permission operations through a custom delegate client.
  • Use Case: Use this when you need to wrap a specialized coding agent (like crush-acp) inside a Pydantic AI agent to perform complex, multi-step tasks that require both structured output and autonomous tool execution.

Quick Start

Use the pydantic-acp skill to initialize a new ACP model by providing the command list and a delegate client to handle host operations.

Frequently Asked Questions about pydantic-acp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use ACP CLI agents as Pydantic AI models?

You can use ACP CLI agents as Pydantic AI models by wrapping them as model providers, which facilitates complex agentic tasks requiring structured output and tool execution via a delegate client.

What is the Agent Client Protocol used for in Pydantic AI workflows?

The Agent Client Protocol (ACP) is used in Pydantic AI workflows to integrate ACP-compliant CLI agents, enabling host-level interaction and managing the session lifecycle and JSON-RPC communication.

Why does my ACP integration keep throwing JSON-RPC parsing errors?

JSON-RPC parsing errors and process leaks are common pitfalls when integrating ACP CLI tools; wrapping them as Pydantic AI models with a custom delegate client avoids these issues by managing the session lifecycle.

Do I need a valid ACP stdio server to use Pydantic AI with CLI agents?

Yes, using Pydantic AI with ACP CLI agents requires the pydantic-acp package and a valid ACP stdio server implementation to manage the session lifecycle and JSON-RPC communication.

Can I use specialized coding agents like crush inside a Pydantic AI agent?

Yes, you can wrap specialized coding agents like crush-acp inside a Pydantic AI agent to perform complex, multi-step tasks that require both structured output and autonomous tool execution.

How do I handle filesystem and terminal operations when using ACP with Pydantic AI?

You handle filesystem, terminal, and permission operations through a custom delegate client, which provides a robust interface for managing host operations during the ACP agent session.