CopilotKit CLI

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:

  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.

  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.