copilotkit-upgrade

Upgrade CopilotKit v1 applications to v2 with AG-UI protocol runtime.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/aranlucas/agents --skill copilotkit-upgrade-aranlucas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: copilotkit-upgrade
Source: https://github.com/aranlucas/agents/tree/main/.agents/skills/copilotkit-upgrade
Command: npx skills add https://github.com/aranlucas/agents --skill copilotkit-upgrade-aranlucas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill assists in seamlessly upgrading CopilotKit v1 applications to the latest v2 version, providing detailed instructions and guidance to update package imports, replace deprecated hooks and components, and adapt to the new AG-UI protocol runtime.

Core Features & Use Cases

  • Comprehensive Upgrade Instructions: Walks you through updating package imports, replacing deprecated APIs, and adapting to the new runtime.
  • Code Audit and Replacement: Identifies deprecated APIs and provides replacements with detailed examples.
  • Runtime Configuration Update: Guides on updating the CopilotRuntime configuration to use AG-UI agents directly.
  • Provider and Hook Renames: Lists all renaming changes in hooks and provider components.
  • Use Case: If you have a CopilotKit v1 application and need to upgrade to v2, this skill will guide you through the entire process, ensuring a smooth transition with minimal disruption.

Quick Start

Run the 'copilotkit-upgrade' skill to initiate the upgrade process for your CopilotKit v1 application.

Frequently Asked Questions about copilotkit-upgrade

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

FAQPage Schema
How do I upgrade my CopilotKit v1 application to v2?

To upgrade CopilotKit v1 to v2, you need to update package imports, replace deprecated APIs, and configure the CopilotRuntime to use AG-UI agents directly. This process also involves renaming specific provider components and hooks to align with the v2 architecture.

What are the major API changes when migrating to CopilotKit v2?

The major API changes in CopilotKit v2 include the deprecation of certain hooks and components, alongside the introduction of the AG-UI protocol runtime. You must adapt your runtime configuration to utilize AG-UI agents directly and apply necessary provider and hook renames.

How do I configure the CopilotRuntime for the AG-UI protocol?

Configuring the CopilotRuntime for the AG-UI protocol requires updating your setup to use AG-UI agents directly. This adaptation replaces older v1 runtime configurations and ensures your application communicates correctly with the new protocol runtime environment.

Do I need to know the AG-UI protocol to migrate CopilotKit?

Yes, a basic understanding of the AG-UI protocol is required to migrate CopilotKit v1 applications to v2. This knowledge is necessary for properly adapting to the new runtime configuration and effectively managing the protocol's agent integrations.

What is the best way to find and replace deprecated CopilotKit hooks?

The best way to replace deprecated CopilotKit hooks is through a code audit that identifies outdated APIs and provides their v2 equivalents. This process includes applying specific provider and hook renames with detailed examples to ensure a smooth transition.