CopilotKit v1.50 is now available. This page gives an overview of what is new, what is coming, and what just stays the same.

Getting Started

Set your CopilotKit version to:

npm install @copilotkit/react-core@latest @copilotkit/react-ui@latest @copilotkit/runtime@latest

Overview

CopilotKit v1.50 is a major update. It includes requested features, internal simplifications, and improvements to existing core elements:

Backwards Compatibility

Everything you’re already using continues to work. v1.50 is fully backwards compatible with client code using v1.10. In fact, as a first step in this pre-release period, we would love for you to start with just rebuilding, and let us know if you run into any problems.

V2 interfaces

As we said above, all of the v1 (or unversioned) hooks continue to work with v1.50. To take advantage of new hooks you’ll use those marked as /v2 (shown below).

You can opt into any of the new developer interfaces or keep using the old ones. Mixing is allowed in the following configurations:

• New Chat component + old hooks

• Old components + new hooks

• New v2 APIs are exposed under a subpath:

  tsxCopy

  import { CopilotKit, useAgent } from "@copilotkit/react-core/v2";
  

useAgent

The v2 hook useAgent is a proper superset of useCoAgent which gives more control over the agent connection, including:

Shared state

```tsx

const { agent } = useAgent({ agentId: "my-agent" });

agent.state
agent.setState
```

Time travel

```tsx

const { agent } = useAgent({ agentId: "my-agent" });

agent.setMessages()
```

Multi-agent execution

```tsx

const { agent: langgraph } = useAgent({ agentId: "langgraph" });
const { agent: pydantic } = useAgent({ agentId: "pydantic" });

[langgraph, pydantic].forEach((agent) => {
  agent.addMessage({ id: crypto.randomUUID(), role: "user", content: message });
  agent.runAgent();
});
```

Agent Mutual Awareness

You can even make agents aware of each other!

```tsx

const { agent: langgraph } = useAgent({ agentId: "langgraph" });
const { agent: pydantic } = useAgent({ agentId: "pydantic" });

langgraph.setMessages(pydantic.messages)
pydantic.setMessages(langgraph.messages)
```

Coming Soon

v1.50 is available now, with useAgent fully ready. The other features (listed below) will be added as they come out in the near future.

Threads & Persistence

v1.50 delivers support for threaded conversations, with built-in thread storage and connection components. For development, use InMemory or SQLite.

Thread storage

- **For development:** `InMemory` or `SQLite`

    ```tsx

    const runtime = new CopilotRuntime({
      agents: {
        default: agent,
      },
      runner: new InMemoryAgentRunner(), // new abstraction for persistence
    });
    ```

- **For production**
    - Use the **Enterprise Intelligence Platform**, managed via **Copilot Cloud** or self-hosted via **Copilot Enterprise**, to persist threads, get automatic stream reconnection, and in-built product analytics. See the [Threads guide](/threads) to get started on the free Developer tier.
        - **👉 Join the [Enterprise Early Access](https://go.copilotkit.ai/enterprise-threads-waitlist) form.**

Thread connection

- Loading a thread

    ```tsx

    <CopilotChat threadId="xyz" /> // connects to runtime's runner
    ```

- Stream reconnection

    ```tsx

    <CopilotChat threadId="xyz" /> // will reconnect if page is reloaded
    ```

New Design System

You can continue to use the design system in the v1 interfaces, but v2 provides A full UI overhaul with deeper customization:

• New CopilotChat, CopilotSidebar, CopilotPopup
  • Just an import away at @copilotkit/react-core/v2
  • New slot system for flexible overrides
  • Much better out-of-the-box markdown rendering
• Suggestions API that works cleanly with agents

Zod Schema Support

Many CopilotKit hooks now take Zod schemas, enforcing type safety at both compile and run time.

• useHumanInTheLoop - now takes Zod schemas
• useFrontendTool - now takes Zod schemas
• useRenderToolCall - new dev-experience principles

Simplified Infrastructure

Earlier versions of CopilotKit required GraphQL installation. That is completely removed by the new architecture.

Direct to LLM Improvements

Our direct to LLM integration now supports more models and implements shared state.

BuiltInAgent - Now with broader model support

const runtime = new CopilotRuntime({
  agents: {
    myAgent: new BuiltInAgent({
      model: "openai/gpt-4o-mini", // much broader model support
      prompt: "You are a helpful AI assistant.",
      temperature: 0.7,
    }),
  },
});

Shared state support

const { agent } = useAgent({ agentId: "myAgent" });
const { state, setState } = agent;

Sharing Feedback and Getting Help

Find an issue? We'd Love Your Feedback

If you run into anything unexpected:

Please raise an issue in the CopilotKit Discord support channel.

Your feedback is incredibly valuable at this stage.

Does Your Team Need Help?

If you’re using CopilotKit in a production product or business, we’d love to help.

You can schedule time with the team here:

👉 Scheduling link