# Copilotkit CLI

Use for the CopilotKit CLI, `npx copilotkit@latest`.

- Repository: https://github.com/CopilotKit/CopilotKit (38452 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add CopilotKit/CopilotKit --skill copilotkit-cli -g -a claude-code -y`
Codex: `npx skills add CopilotKit/CopilotKit --skill copilotkit-cli -g -a codex -y`
Cursor: `npx skills add CopilotKit/CopilotKit --skill copilotkit-cli -g -a cursor -y`
Gemini CLI: `npx skills add CopilotKit/CopilotKit --skill copilotkit-cli -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add CopilotKit/CopilotKit`

## Description

Use for the CopilotKit CLI, `npx copilotkit@latest`. Covers proving a project's wiring with `verify` before debugging anything by hand, scaffolding with `create`, signing in and selecting a hosted Intelligence project, agent-assisted onboarding of an existing app, generating type-safe agent ids, and importing thread history. Reach for `verify` first whenever a CopilotKit app is not working.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# CopilotKit CLI

```bash
npx copilotkit@latest <command> --via skill:copilotkit-cli
```

Keep `--via skill:copilotkit-cli` on every command you run from this skill. It only tells
CopilotKit's telemetry that the call came from this skill, and the command ignores it.
If the CLI reports `Unknown option '--via'`, npx ran an old cached version: run the command
again without the flag.

`--help` on any command prints its flags. The commands below are the ones worth knowing
before you start reading someone's project by hand.

## `verify`, do this before debugging

First decide whether the app uses hosted Intelligence. `verify` checks for it by default, and
an open-source app fails those checks every time.

- **No Intelligence:** nothing constructs `CopilotKitIntelligence` where the runtime is
  built, and there is no `.copilotkit/project.json`. Run the open-source check, with an agent
  id the runtime registers:

  ```bash
  npx copilotkit@latest verify --expect-runtime oss --round-trip --agent <id> --json --via skill:copilotkit-cli
  ```

  `--round-trip --agent <id>` is required here. Without it the round trip is not attempted
  and the command cannot pass.

- **Otherwise:** run the default check.

  ```bash
  npx copilotkit@latest verify --json --via skill:copilotkit-cli
  ```

Do not run `login` or `project select` only to make `verify` pass. Those commands set up
hosted Intelligence. They do not fix an open-source app, and `verify` still fails on it
afterward, because the runtime never consumes the credential.

The rest: https://github.com/CopilotKit/CopilotKit/blob/HEAD/skills/copilotkit-cli/SKILL.md