// CopilotKit pre-commit hook reference. Load automatically when the user mentions git hooks failing, pre-commit errors, lefthook issues, commit blocked, or "hooks don't work", or when user wants to commit/push anything Contains the full hook topology so debugging skips discovery and goes straight to diagnosis.
Build, debug, and regression-test CopilotKit showcase demos. Use when working under showcase/, creating new showcase demos/items/cells/pills, implementing showcase features, investigating showcase demo bugs, D5/e2e-deep failures, aimock fixture gaps, direct-LLM versus aimock behavior, recording fixtures, testing every demo pill/cell, verifying repeated and interleaved suggestion-pill fixture stability, enforcing langgraph-python 1:1 parity, or migrating a demo to the v2 CopilotKit showcase flow.
Build, debug, and regression-test CopilotKit showcase demos. Use when working under showcase/, creating new showcase demos/items/cells/pills, implementing showcase features, investigating showcase demo bugs, D5/e2e-deep failures, aimock fixture gaps, direct-LLM versus aimock behavior, recording fixtures, testing every demo pill/cell, verifying repeated and interleaved suggestion-pill fixture stability, enforcing langgraph-python 1:1 parity, or migrating a demo to the v2 CopilotKit showcase flow.
Keeps examples/integrations/* demos aligned to the north-star (langgraph-python). Use when the user says "sync demos", "sync integrations", "port to north-star", "align integration demos", "parity check", or when working inside examples/integrations/ and tracked files diverge. Drives the pnpm parity:sync / parity:verify commands and handles the manual-merge zones (agent code, api route, Dockerfile).
@copilotkit/react-core — mount CopilotKitProvider in a Next.js App Router / React Router v7 / TanStack Start / SPA app, drop in CopilotChat/CopilotPopup/CopilotSidebar (v2 chat components ship from react-core/v2 — NOT react-ui, which is CSS-only in v2), access and subscribe to agents with useAgent / useAgentContext / useCapabilities, switch between multiple agents, manage durable Intelligence threads with useThreads, register browser-side tools via useFrontendTool, render tool calls with useRenderTool / useComponent / useDefaultRenderTool, gate execution with useHumanInTheLoop, wire file attachments with useAttachments, configure suggestion pills, and register activity- and custom-message renderers. publicLicenseKey is canonical (publicApiKey is deprecated alias). Load the reference under references/ that matches your task.
@copilotkit/runtime — mount a fetch-native CopilotRuntime on any JS server, wire middleware, pick an AgentRunner, instantiate BuiltInAgent (Factory Mode with TanStack AI is the preferred default) or plug in any of 12 external agent frameworks (Mastra, LangGraph, CrewAI Crews/Flows, PydanticAI, ADK, LlamaIndex, Agno, AWS Strands, MS Agent Framework, AG2, A2A), enable Intelligence mode for durable threads + websocket, register server-side tools via defineTool, and wire voice transcription. Uses the fetch-based createCopilotRuntimeHandler primitive — the Express/Hono adapters are discouraged. Load the reference under references/ that matches your task.
Pre-deploy checklist for CopilotKit v2 apps — persistent AgentRunner (not InMemory) behind horizontal scaling, CORS, showDevConsole off, debug off, credentials:'include' for cookie auth, env-sourced secrets on edge runtimes, publicApiKey / licenseToken, dev-only-prop audit (agents__unsafe_dev_only, selfManagedAgents). Pointer skill — does NOT teach auth, rate-limit, or observability (those are server- framework concerns wired via the middleware skill). Load before any first production deploy of a CopilotKit v2 app.
| name | git-hooks |
| description | CopilotKit pre-commit hook reference. Load automatically when the user mentions git hooks failing, pre-commit errors, lefthook issues, commit blocked, or "hooks don't work", or when user wants to commit/push anything Contains the full hook topology so debugging skips discovery and goes straight to diagnosis. |
| metadata | {"internal":true} |
The repo uses lefthook (not husky). The git hook at .git/hooks/pre-commit calls lefthook, which reads lefthook.yml at the repo root.
Config file: lefthook.yml
sync-lockfile lint-fix test-and-check-packages
sync-lockfile**/package.json files are stagedpnpm i --lockfile-onlystage_fixed: true: auto-stages the updated lockfilelint-fixpnpm run lint --fix && pnpm run formatnx run-many -t lint --projects=packages/** then prettier --write "**/*.{ts,tsx,md}"stage_fixed: true: auto-stages any files it fixes--fix can't auto-correcttest-and-check-packages ← most common failurepnpm run test && pnpm run check:packagesnx run-many -t test — runs all unit tests across all packagesnx run-many -t publint,attw --projects=packages/** — checks package exports and types are correctly declaredstage_fixed: false — does NOT auto-stage anythingNX_TUI: "false" (plain output, no interactive UI)publint finds malformed package.json exportsattw (Are the Types Wrong?) finds type declaration issuesThe summary shows a boxing glove 🥊 for the failing command. The error itself does not show directly. To see the actual error:
# Run only the failing command manually:
pnpm run test # if test-and-check-packages failed
pnpm run check:packages # isolate publint/attw from test failures
nx run-many -t test --projects=<pkg> # narrow to a specific package
# Re-run lefthook manually (without committing):
pnpm lefthook run pre-commit
| Script | Expands to |
|---|---|
pnpm run lint | nx run-many -t lint --projects=packages/** |
pnpm run format | prettier --write "**/*.{ts,tsx,md}" |
pnpm run test | nx run-many -t test |
pnpm run check:packages | nx run-many -t publint,attw --projects=packages/** |