Files
copilotkit__copilotkit/packages/cli/README.md
Tyler Slaton 96885b5959 refactor: consolidate V1/V2 packages into flat @copilotkit/* structure
Flatten all packages from packages/v1/* and packages/v2/* into packages/* —
every package now lives directly under the @copilotkit/ scope with no v1/v2
subdirectories.

- Move all v1 packages (react-core, react-ui, runtime, shared, etc.) from
  packages/v1/* to packages/*
- Absorb v2 react code into packages/react-core/src/v2/ (exported via /v2 subpath)
- Absorb v2 agent code into packages/runtime/src/agent/ (exported via /v2 subpath)
- Move v2 packages (core, angular, demo-agents, etc.) to packages/*
- Replace all @copilotkitnext/* imports with @copilotkit/* equivalents
- Keep @copilotkitnext/angular as the sole exception (angular remains on next)
- Update CI workflows, renovate config, release scripts for flat structure
- No public API surface changes — all exports fields are preserved

Co-authored-by: Alem Tuzlak <t.zlak@hotmail.com>
Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
2026-03-28 16:45:10 -07:00

2.2 KiB

🪁 CopilotKit CLI

NOTE: The CopilotKit CLI is an optional tool that enhances the developer experience of CopilotKit. It is not required to use CopilotKit. Click here to get started with CopilotKit..

Version Downloads/week

What is the CopilotKit CLI?

The CopilotKit CLI boosts your CopilotKit development experience. It integrates neatly with Copilot Cloud.

Installation

# npm
npm install -g copilotkit

# pnpm
pnpm install -g copilotkit

# yarn
yarn global add copilotkit

Commands

init: Add CopilotKit to your Next.js project

The fastest way to add CopilotKit to your Next.js project is with the init command:

# Navigate to your Next.js project
cd my-nextjs-app

# Run the init command
copilotkit init

This interactive command will:

  • Set up the required UI components
  • Configure AI agents if desired (LangGraph, CrewAI)
  • Connect to Copilot Cloud (optional)
  • Create all necessary configuration files

You can also pass flags to automate the setup:

copilotkit init --mode LangGraph

login: Authenticating with Copilot Cloud

First, ensure you have an account on Copilot Cloud.

Then, run the following command to authenticate with Copilot Cloud:

copilotkit login

dev: Local Endpoint Development

The CopilotKit CLI allows you to create a local tunnel to your CopilotKit remote endpoints, agents, and LangGraph apps.

For example, to create a local tunnel to an endpoint running locally on port 8000, you can run:

copilotkit dev --port 8000

Need help?

You can always run copilotkit --help to get help on the CopilotKit CLI.

You're welcome to join our Discord to get help from the CopilotKit team and community.