# Fork and merge Pydantic AI agent runs with Pydantic Deep Agents

> Run a self-hosted terminal agent or custom Pydantic AI harness that can branch a coding or research run, test isolated alternatives, and merge the winning branch.

- Skill: `agentskillexchange/fork-and-merge-pydantic-ai-agent-runs-with-pydantic-deep-age` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/fork-and-merge-pydantic-ai-agent-runs-with-pydantic-deep-age`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/fork-and-merge-pydantic-ai-agent-runs-with-pydantic-deep-age/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/fork-and-merge-pydantic-ai-agent-runs-with-pydantic-deep-age

---


# Fork and merge Pydantic AI agent runs with Pydantic Deep Agents

Run a self-hosted terminal agent or custom Pydantic AI harness that can branch a coding or research run, test isolated alternatives, and merge the winning branch.

## Prerequisites

Python 3.10+, pydantic-deep CLI or Python package, approved model provider key, optional sandbox support for isolated execution

## Installation

Install the package in the Python environment that will run the local agent harness:

```bash
pip install pydantic-deep
```

Use the upstream documentation for current CLI and framework setup details:

- https://vstorm-co.github.io/pydantic-deepagents/

A minimal ASE-safe workflow is:

1. Install the package and CLI in an isolated Python environment.
2. Configure only the approved model provider credentials needed by your harness.
3. Run a branch or fork workflow from a self-hosted terminal agent or custom Pydantic AI agent.
4. Compare branch outputs with tests, traces, or review notes.
5. Merge or select the winning branch only after a human reviews the evidence.

Treat this as a self-hosted custom-agent workflow for branching and evaluating Pydantic AI runs. It is not a generic Claude Code replacement, and it should not be wired to broad shell or repository permissions until the branch/test/merge loop is constrained and reviewed.

## Documentation

- https://vstorm-co.github.io/pydantic-deepagents/

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/fork-and-merge-pydantic-ai-agent-runs-with-pydantic-deep-agents/)