copilotkit 3.0.1 → 3.0.3

package/README.md

@@ -1,6 +1,8 @@
 # CopilotKit CLI
 
-The CopilotKit CLI scaffolds starter apps and manages local CLI authentication for CopilotKit Intelligence onboarding.
+The CopilotKit CLI scaffolds starter apps, connects project creation to a
+CopilotKit workspace through the Ops/Clerk platform, and manages local CLI
+authentication for CopilotKit Intelligence onboarding.
 
 ## Install
 
@@ -30,6 +32,11 @@ copilotkit whoami
 
 Use `copilotkit docs` to open <https://docs.copilotkit.ai> in your browser. In CI, or when the browser cannot be opened, the CLI prints the URL instead.
 
+Use `copilotkit login` when you want to sign in before running workspace-gated
+commands. It stores the local CLI session used by `whoami`, `license`, and the
+`init`/`create` workspace connection; it does not scaffold a project or issue a
+license key by itself.
+
 The onboarding commands are:
 
 - `copilotkit init`
@@ -49,6 +56,12 @@ flag is retained as a deprecated no-op for backward compatibility.
 
 Supported framework values include `langgraph-py`, `langgraph-js`, `mastra`, `pydantic-ai`, `aws-strands-py`, `adk`, `a2a`, `microsoft-agent-framework-dotnet`, `microsoft-agent-framework-py`, `flows`, `llamaindex`, and `agno`.
 
+`init` and `create` collect your starter choices, then connect project creation
+to your CopilotKit workspace through Ops/Clerk before scaffolding. If you
+already have a valid CLI session, the CLI reuses that workspace connection;
+otherwise it opens browser sign-in. This workspace connection is required for
+project creation and is separate from license issuance.
+
 ## Skills And Agent-Assisted Onboarding
 
 Use `copilotkit create` to start a **new** project. Use `copilotkit skills onboard`
@@ -94,11 +107,18 @@ The CLI expects:
 - Python 3.10+ for the A2A template.
 - The .NET SDK for the Microsoft Agent Framework .NET template.
 
-Every `init` authenticates with your CopilotKit account before scaffolding (browser sign-in when no session exists). Threads-framework templates additionally issue a CopilotKit license key and write it into the generated project.
+Project creation requires a CopilotKit workspace connection through Ops/Clerk
+(browser sign-in when no session exists). Standard framework templates use that
+connection only to authorize creation; they do not request or write a license
+key. Threads-framework templates additionally issue a CopilotKit license key and
+write it into the generated project.
 
 ## Environment Files
 
-The scaffold step copies `.env.example` to `.env` when a template provides one. If the selected template requires a license, the CLI also ensures `COPILOTKIT_LICENSE_TOKEN` is present in `.env`.
+The scaffold step copies `.env.example` to `.env` when a template provides one.
+If the selected starter requires a license, the CLI also ensures
+`COPILOTKIT_LICENSE_TOKEN` is present in `.env`. Standard starters do not receive
+a license token.
 
 After creation, add any provider secrets required by the template. Most templates use OpenAI:
 
@@ -145,10 +165,11 @@ copilotkit logs --tail --lines 100
 
 With no flags, `copilotkit logs` prints the log file path. `--tail` prints recent structured log lines. Add `--verbose` to a CLI command when you need high-signal diagnostics mirrored to stderr during the run.
 
-License, license list, and Intelligence init flows revalidate the live Clerk
-organization before using local auth. If that check fails because the cached
-session is stale, the CLI may clear local auth and rerun browser login before
-continuing.
+Project creation (`init`/`create`) connects to and revalidates the live Clerk
+workspace before scaffolding. License commands, including `license list`,
+revalidate the live Clerk organization before using local auth as needed. If a
+workspace or organization check fails because the cached session is stale, the
+CLI may clear local auth and rerun browser login before continuing.
 
 ## Telemetry
 
@@ -177,3 +198,35 @@ first-run prompt) is always respected; no events are sent until telemetry is
 explicitly re-enabled. `copilotkit telemetry reset` restores the full
 fresh-install state: the decision is forgotten and the one-time notice shows
 again on the next interactive run.
+
+## Prerelease builds
+
+Tester-facing prerelease builds are produced by CI via `workflow_dispatch` on
+the `pkg-pr-new (cli)` workflow — never built locally (the repo root `.env`
+targets local services, and CI is the reproducible path).
+
+```bash
+gh workflow run "pkg-pr-new (cli)" --ref <feature-branch> \
+  -f cli_env=production \
+  -f template_ref=<copilotkit-branch>   # optional; omit to use main
+```
+
+- `cli_env` — endpoint set baked into the binary (`local`, `dev`, `staging`,
+  `production`; defaults to `production`).
+- `template_ref` — `CopilotKit/CopilotKit` branch or tag that `init` templates
+  and the `_intelligence` overlay are pinned to (the workflow validates it
+  exists before building). Empty means `main`. The `ag2`
+  template comes from the third-party `ag2ai/ag2-copilotkit-starter` repo and
+  is never repinned.
+
+Open the workflow run and copy the `npx https://pkg.pr.new/...` command from
+the **job summary**; hand that one-liner to testers. Prerelease binaries
+report `<version>-pre.<shortsha>` from `copilotkit --version`, so a tester's
+build is always identifiable.
+
+Pushes and PRs continue to publish `CLI_ENV=local` builds automatically, as
+before.
+
+Note: `workflow_dispatch` only works against refs that contain the dispatch
+trigger — branches cut before this workflow landed need a merge from `main`
+first.

package/index.js

@@ -40,6 +40,69 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
+// apps/cli/src/config.ts
+var config_exports = {};
+__export(config_exports, {
+  getBuildInfo: () => getBuildInfo,
+  getC15tBackendUrl: () => getC15tBackendUrl,
+  getOpsApiUrl: () => getOpsApiUrl,
+  getOpsFrontendUrl: () => getOpsFrontendUrl,
+  getPrivacyPolicyUrl: () => getPrivacyPolicyUrl,
+  getPrivacyPolicyVersion: () => getPrivacyPolicyVersion,
+  getTelemetryEndpointUrl: () => getTelemetryEndpointUrl,
+  getTemplateRef: () => getTemplateRef,
+  setOpsApiUrl: () => setOpsApiUrl,
+  setOpsFrontendUrl: () => setOpsFrontendUrl
+});
+function getOpsApiUrl() {
+  return opsApiUrlOverride ?? "https://api.operations.copilotkit.ai";
+}
+function setOpsApiUrl(url2) {
+  opsApiUrlOverride = url2;
+}
+function getOpsFrontendUrl() {
+  return opsFrontendUrlOverride ?? "https://dashboard.operations.copilotkit.ai";
+}
+function setOpsFrontendUrl(url2) {
+  opsFrontendUrlOverride = url2;
+}
+function getTelemetryEndpointUrl() {
+  const override = process.env["COPILOTKIT_TELEMETRY_ENDPOINT"]?.trim();
+  if (override) {
+    return override;
+  }
+  return true ? "https://telemetry.copilotkit.ai/ingest" : "https://telemetry.copilotkit.ai/ingest";
+}
+function getBuildInfo() {
+  return {
+    version: true ? "3.0.3" : "dev",
+    buildNumber: true ? "27069185263" : "dev",
+    commitSha: true ? "e755d181d0cbfbf5b6efb885b2a9f14425ebc187" : "dev"
+  };
+}
+function getTemplateRef() {
+  return true ? "main" : "main";
+}
+function getC15tBackendUrl() {
+  return true ? "https://calm-hazelnut-joy-copilotkit.inth.app" : "";
+}
+function getPrivacyPolicyUrl() {
+  return PRIVACY_POLICY_URL;
+}
+function getPrivacyPolicyVersion() {
+  return PRIVACY_POLICY_VERSION;
+}
+var opsApiUrlOverride, opsFrontendUrlOverride, PRIVACY_POLICY_URL, PRIVACY_POLICY_VERSION;
+var init_config = __esm({
+  "apps/cli/src/config.ts"() {
+    "use strict";
+    opsApiUrlOverride = null;
+    opsFrontendUrlOverride = null;
+    PRIVACY_POLICY_URL = "https://www.copilotkit.ai/privacy-policy";
+    PRIVACY_POLICY_VERSION = "2026-06-04";
+  }
+});
+
 // apps/cli/src/services/agentcore-config.ts
 import * as fs from "node:fs";
 import * as path from "node:path";
@@ -223,6 +286,14 @@ function isAgentFramework(value) {
 function formatInvalidFrameworkError(value) {
   return `Unsupported framework "${value}". Expected one of: ${AGENT_FRAMEWORKS.join(", ")}.`;
 }
+function ckTemplate(examplePath, ref = getTemplateRef()) {
+  return {
+    owner: "CopilotKit",
+    repo: "CopilotKit",
+    branch: ref,
+    path: examplePath
+  };
+}
 function standardTemplate(framework, template, successEmoji) {
   const pythonUvTemplates = /* @__PURE__ */ new Set([
     "langgraph-py",
@@ -286,10 +357,11 @@ function formatIntelligenceUnavailableError(framework) {
     ...THREADS_FRAMEWORKS
   ].join(", ")}.`;
 }
-var AGENT_FRAMEWORKS, FRAMEWORK_ALIASES, FRAMEWORK_EMOJI, FRAMEWORK_CHOICES, AG2_TEMPLATE_SOURCE, COPILOTKIT_LANGGRAPH_PYTHON_URL, COPILOTKIT_AGENTCORE_URL, TEMPLATE_REPOS, UV_PREREQUISITE, DOCKER_PREREQUISITE, DOTNET_PREREQUISITE, PYTHON3_PREREQUISITE, OPENAI_ENV_KEY, GOOGLE_ENV_KEY, COPILOTKIT_LICENSE_ENV_KEY, FRAMEWORK_TEMPLATES, THREADS_FRAMEWORKS;
+var AGENT_FRAMEWORKS, FRAMEWORK_ALIASES, FRAMEWORK_EMOJI, FRAMEWORK_CHOICES, AG2_TEMPLATE_SOURCE, COPILOTKIT_LANGGRAPH_PYTHON_TEMPLATE, COPILOTKIT_AGENTCORE_TEMPLATE, TEMPLATE_REPOS, UV_PREREQUISITE, DOCKER_PREREQUISITE, DOTNET_PREREQUISITE, PYTHON3_PREREQUISITE, OPENAI_ENV_KEY, GOOGLE_ENV_KEY, COPILOTKIT_LICENSE_ENV_KEY, FRAMEWORK_TEMPLATES, THREADS_FRAMEWORKS;
 var init_types = __esm({
   "apps/cli/src/types.ts"() {
     "use strict";
+    init_config();
     init_agentcore_config();
     init_showcase_config();
     init_event_properties();
@@ -323,18 +395,18 @@ var init_types = __esm({
       mastra: "\u{1F311}",
       "pydantic-ai": "\u{1F53C}",
       llamaindex: "\u{1F999}",
-      agno: "\u{1F170}\uFE0F",
+      agno: "\u{1F9E0}",
       ag2: "\u{1F916}",
       adk: "\u{1F916}",
       a2a: "\u{1F916}",
       "aws-strands-py": "\u{1F9EC}",
       "microsoft-agent-framework-dotnet": "\u{1F7E6}",
       "microsoft-agent-framework-py": "\u{1F7E6}",
-      "mcp-apps": "\u264D",
-      "agentcore-langgraph": "\u2601\uFE0F",
-      "agentcore-strands": "\u2601\uFE0F",
+      "mcp-apps": "\u{1F9E9}",
+      "agentcore-langgraph": "\u26C5",
+      "agentcore-strands": "\u26C5",
       a2ui: "\u{1F3A8}",
-      opengenui: "\u{1F5BC}\uFE0F"
+      opengenui: "\u2728"
     };
     FRAMEWORK_CHOICES = [
       {
@@ -389,27 +461,35 @@ var init_types = __esm({
       branch: "main",
       path: ""
     };
-    COPILOTKIT_LANGGRAPH_PYTHON_URL = "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/langgraph-python";
-    COPILOTKIT_AGENTCORE_URL = "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/agentcore";
+    COPILOTKIT_LANGGRAPH_PYTHON_TEMPLATE = ckTemplate(
+      "examples/integrations/langgraph-python"
+    );
+    COPILOTKIT_AGENTCORE_TEMPLATE = ckTemplate(
+      "examples/integrations/agentcore"
+    );
     TEMPLATE_REPOS = {
-      "langgraph-py": COPILOTKIT_LANGGRAPH_PYTHON_URL,
-      "langgraph-js": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/langgraph-js",
-      mastra: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/mastra",
-      flows: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/crewai-flows",
-      llamaindex: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/llamaindex",
-      agno: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/agno",
-      "pydantic-ai": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/pydantic-ai",
+      "langgraph-py": COPILOTKIT_LANGGRAPH_PYTHON_TEMPLATE,
+      "langgraph-js": ckTemplate("examples/integrations/langgraph-js"),
+      mastra: ckTemplate("examples/integrations/mastra"),
+      flows: ckTemplate("examples/integrations/crewai-flows"),
+      llamaindex: ckTemplate("examples/integrations/llamaindex"),
+      agno: ckTemplate("examples/integrations/agno"),
+      "pydantic-ai": ckTemplate("examples/integrations/pydantic-ai"),
       ag2: AG2_TEMPLATE_SOURCE,
-      adk: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/adk",
-      "aws-strands-py": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/strands-python",
-      a2a: "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/a2a-middleware",
-      "microsoft-agent-framework-dotnet": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/ms-agent-framework-dotnet",
-      "microsoft-agent-framework-py": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/ms-agent-framework-python",
-      "mcp-apps": "https://github.com/CopilotKit/CopilotKit/tree/main/examples/integrations/mcp-apps",
-      "agentcore-langgraph": COPILOTKIT_AGENTCORE_URL,
-      "agentcore-strands": COPILOTKIT_AGENTCORE_URL,
-      a2ui: COPILOTKIT_LANGGRAPH_PYTHON_URL,
-      opengenui: COPILOTKIT_LANGGRAPH_PYTHON_URL
+      adk: ckTemplate("examples/integrations/adk"),
+      "aws-strands-py": ckTemplate("examples/integrations/strands-python"),
+      a2a: ckTemplate("examples/integrations/a2a-middleware"),
+      "microsoft-agent-framework-dotnet": ckTemplate(
+        "examples/integrations/ms-agent-framework-dotnet"
+      ),
+      "microsoft-agent-framework-py": ckTemplate(
+        "examples/integrations/ms-agent-framework-python"
+      ),
+      "mcp-apps": ckTemplate("examples/integrations/mcp-apps"),
+      "agentcore-langgraph": COPILOTKIT_AGENTCORE_TEMPLATE,
+      "agentcore-strands": COPILOTKIT_AGENTCORE_TEMPLATE,
+      a2ui: COPILOTKIT_LANGGRAPH_PYTHON_TEMPLATE,
+      opengenui: COPILOTKIT_LANGGRAPH_PYTHON_TEMPLATE
     };
     UV_PREREQUISITE = {
       command: "uv",
@@ -711,65 +791,6 @@ var init_event_properties = __esm({
   }
 });
 
-// apps/cli/src/config.ts
-var config_exports = {};
-__export(config_exports, {
-  getBuildInfo: () => getBuildInfo,
-  getC15tBackendUrl: () => getC15tBackendUrl,
-  getOpsApiUrl: () => getOpsApiUrl,
-  getOpsFrontendUrl: () => getOpsFrontendUrl,
-  getPrivacyPolicyUrl: () => getPrivacyPolicyUrl,
-  getPrivacyPolicyVersion: () => getPrivacyPolicyVersion,
-  getTelemetryEndpointUrl: () => getTelemetryEndpointUrl,
-  setOpsApiUrl: () => setOpsApiUrl,
-  setOpsFrontendUrl: () => setOpsFrontendUrl
-});
-function getOpsApiUrl() {
-  return opsApiUrlOverride ?? "https://api.operations.copilotkit.ai";
-}
-function setOpsApiUrl(url2) {
-  opsApiUrlOverride = url2;
-}
-function getOpsFrontendUrl() {
-  return opsFrontendUrlOverride ?? "https://dashboard.operations.copilotkit.ai";
-}
-function setOpsFrontendUrl(url2) {
-  opsFrontendUrlOverride = url2;
-}
-function getTelemetryEndpointUrl() {
-  const override = process.env["COPILOTKIT_TELEMETRY_ENDPOINT"]?.trim();
-  if (override) {
-    return override;
-  }
-  return true ? "https://telemetry.copilotkit.ai/ingest" : "https://telemetry.copilotkit.ai/ingest";
-}
-function getBuildInfo() {
-  return {
-    version: true ? "3.0.1" : "dev",
-    buildNumber: true ? "27023475022" : "dev",
-    commitSha: true ? "12b5e551b94b97bdc29f9345eed689a8abc63837" : "dev"
-  };
-}
-function getC15tBackendUrl() {
-  return true ? "https://calm-hazelnut-joy-copilotkit.inth.app" : "";
-}
-function getPrivacyPolicyUrl() {
-  return PRIVACY_POLICY_URL;
-}
-function getPrivacyPolicyVersion() {
-  return PRIVACY_POLICY_VERSION;
-}
-var opsApiUrlOverride, opsFrontendUrlOverride, PRIVACY_POLICY_URL, PRIVACY_POLICY_VERSION;
-var init_config = __esm({
-  "apps/cli/src/config.ts"() {
-    "use strict";
-    opsApiUrlOverride = null;
-    opsFrontendUrlOverride = null;
-    PRIVACY_POLICY_URL = "https://www.copilotkit.ai/privacy-policy";
-    PRIVACY_POLICY_VERSION = "2026-06-04";
-  }
-});
-
 // node_modules/.pnpm/dot-prop@10.1.0/node_modules/dot-prop/index.js
 function shouldCoerceToNumber(segment) {
   if (segment === "0") {
@@ -90099,6 +90120,10 @@ async function login(options = {}) {
       ...isCliAuthDiagnosticsVerboseEnabled() ? { verbose: "1" } : {},
       ...posthogDistinctId !== null ? { posthog_distinct_id: posthogDistinctId } : {}
     });
+    if (options.authHandoff) {
+      loginParams.set("source", options.authHandoff.source);
+      loginParams.set("mode", options.authHandoff.mode);
+    }
     const loginUrl = `${getOpsFrontendUrl()}/cli-auth?${loginParams.toString()}`;
     diagnostics.logPhase("login.browser-url-prepared", {
       callback: summarizeCallbackUrl(callbackUrl),
@@ -90983,7 +91008,9 @@ function useBrowserLogin() {
   }
   return context;
 }
-function BrowserLoginConfirmation() {
+function BrowserLoginConfirmation({
+  reason
+} = {}) {
   const { state, confirmBrowserLoginStart, submitManualClerkToken } = useBrowserLogin();
   const [manualTokenInput, setManualTokenInput] = (0, import_react35.useState)("");
   use_input_default((_input, key) => {
@@ -90996,6 +91023,7 @@ function BrowserLoginConfirmation() {
   }
   if (state.phase === "confirming") {
     return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(Box_default, { flexDirection: "column", children: [
+      reason ? /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Box_default, { marginBottom: 1, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Text, { children: reason }) }) : null,
       /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Text, { children: BROWSER_LOGIN_CONFIRMATION_MESSAGE }),
       /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Text, { color: "gray", children: BROWSER_LOGIN_CONFIRMATION_PROMPT })
     ] });
@@ -91115,12 +91143,21 @@ async function scaffoldProject(options) {
   };
   await cloneTemplate(source, projectDir);
 }
-async function fetchIntelligenceOverlay() {
-  const source = {
+function getIntelligenceOverlaySource(ref = getTemplateRef()) {
+  return {
     owner: "CopilotKit",
     repo: "CopilotKit",
-    branch: "main",
-    subdirectoryPath: "examples/integrations/_intelligence"
+    branch: ref,
+    path: "examples/integrations/_intelligence"
+  };
+}
+async function fetchIntelligenceOverlay() {
+  const overlay = getIntelligenceOverlaySource();
+  const source = {
+    owner: overlay.owner,
+    repo: overlay.repo,
+    branch: overlay.branch,
+    subdirectoryPath: overlay.path
   };
   const overlayDir = fs13.mkdtempSync(
     path9.join(os6.tmpdir(), "copilotkit-overlay-")
@@ -91288,6 +91325,7 @@ var LICENSE_TOKEN_LINE_RE;
 var init_project_scaffold = __esm({
   "apps/cli/src/services/project-scaffold.ts"() {
     "use strict";
+    init_config();
     init_event_properties();
     LICENSE_TOKEN_LINE_RE = /^[ \t]*(?:export\s+)?COPILOTKIT_LICENSE_TOKEN=.*$/m;
   }
@@ -91365,6 +91403,7 @@ var init_license_delivery = __esm({
 // apps/cli/src/commands/license.tsx
 var license_exports = {};
 __export(license_exports, {
+  LICENSE_AUTH_REASON: () => LICENSE_AUTH_REASON,
   runLicense: () => runLicense,
   shouldRenderLicenseCreateBrowserLoginConfirmation: () => shouldRenderLicenseCreateBrowserLoginConfirmation
 });
@@ -91521,10 +91560,14 @@ function LicenseCreateApp({ onIssued }) {
     };
   }, [browserLogin.runLogin, onIssued, exit]);
   if (shouldRenderLicenseCreateBrowserLoginConfirmation(browserLogin.state.phase)) {
-    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(BrowserLoginConfirmation, {});
+    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(BrowserLoginConfirmation, { reason: LICENSE_AUTH_REASON });
   }
   if (phase === "auth") {
     return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(Box_default, { flexDirection: "column", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { children: LICENSE_AUTH_REASON }),
+        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { color: "gray", children: "Sign in with your browser to continue." })
+      ] }),
       authMessage ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { color: "yellow", children: authMessage }) : null,
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Spinner, { label: "Verifying authentication\u2026" })
     ] });
@@ -91590,7 +91633,7 @@ async function runLicense(command) {
     writeStderr: (text) => process.stderr.write(text)
   });
 }
-var import_react36, import_jsx_runtime5;
+var import_react36, import_jsx_runtime5, LICENSE_AUTH_REASON;
 var init_license = __esm({
   async "apps/cli/src/commands/license.tsx"() {
     "use strict";
@@ -91606,6 +91649,7 @@ var init_license = __esm({
     init_project_scaffold();
     init_license_delivery();
     import_jsx_runtime5 = __toESM(require_jsx_runtime(), 1);
+    LICENSE_AUTH_REASON = "A CopilotKit Intelligence license unlocks Threads and other licensed features. Sign in to issue a free license key for this project.";
   }
 });
 
@@ -91765,6 +91809,7 @@ var init_banner = __esm({
 // apps/cli/src/commands/skills.tsx
 var skills_exports = {};
 __export(skills_exports, {
+  SKILLS_AUTH_REASON: () => SKILLS_AUTH_REASON,
   SkillsOnboardApp: () => SkillsOnboardApp,
   runSkills: () => runSkills
 });
@@ -91849,7 +91894,7 @@ function SkillsOnboardApp({
     }
   }, [step, exit]);
   if (step === "authenticating" && shouldRenderBrowserLogin(browserLoginState.phase)) {
-    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(BrowserLoginConfirmation, {});
+    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(BrowserLoginConfirmation, { reason: SKILLS_AUTH_REASON });
   }
   if (step === "authenticating") {
     return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(Box_default, { flexDirection: "column", children: [
@@ -91893,7 +91938,7 @@ async function runSkills(flags) {
   );
   await waitUntilExit();
 }
-var import_react37, import_jsx_runtime7, defaultOnboardDeps;
+var import_react37, import_jsx_runtime7, SKILLS_AUTH_REASON, defaultOnboardDeps;
 var init_skills = __esm({
   async "apps/cli/src/commands/skills.tsx"() {
     "use strict";
@@ -91907,6 +91952,7 @@ var init_skills = __esm({
     await init_browser_login();
     await init_spinner();
     import_jsx_runtime7 = __toESM(require_jsx_runtime(), 1);
+    SKILLS_AUTH_REASON = "A free CopilotKit account is required for agent-assisted onboarding.";
     defaultOnboardDeps = {
       verifyAndRefresh,
       copyToClipboard,
@@ -92439,6 +92485,8 @@ var init_init_flow = __esm({
 // apps/cli/src/commands/init.tsx
 var init_exports = {};
 __export(init_exports, {
+  INIT_AUTH_REASON_ACCOUNT_ONLY: () => INIT_AUTH_REASON_ACCOUNT_ONLY,
+  INIT_AUTH_REASON_WITH_LICENSE: () => INIT_AUTH_REASON_WITH_LICENSE,
   InitApp: () => InitApp,
   buildInitNextSteps: () => buildInitNextSteps,
   commandExists: () => commandExists,
@@ -92529,7 +92577,7 @@ async function ensureCliToken2(dependencies, onTerminalSessionInvalidation, onBr
       openedBrowser = true;
       onBrowserOpened?.();
     }
-    await dependencies.login();
+    await dependencies.login({ authHandoff: PROJECT_CREATION_AUTH_HANDOFF });
   };
   try {
     session = await dependencies.verifyAndRefresh(
@@ -92764,15 +92812,16 @@ function ScaffoldProgress({ options, telemetry }) {
       cancelled = true;
     };
   }, [options, scaffoldDependencies, telemetry]);
+  const authReason = templateDefinition.provisionLicense ? INIT_AUTH_REASON_WITH_LICENSE : INIT_AUTH_REASON_ACCOUNT_ONLY;
   if (shouldRenderInitBrowserLoginConfirmation(browserLogin.state.phase)) {
-    return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(BrowserLoginConfirmation, {});
+    return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(BrowserLoginConfirmation, { reason: authReason });
   }
   if (phase === "auth") {
     return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(Box_default, { flexDirection: "column", children: [
-      templateDefinition.provisionLicense ? /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text, { children: "CopilotKit Intelligence requires a free license." }),
+      /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text, { children: authReason }),
         /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text, { color: "gray", children: "Sign in with your browser to continue." })
-      ] }) : null,
+      ] }),
       authMessage ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text, { color: "yellow", children: authMessage }) : null,
       /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Spinner, { label: "\u{1FA81} Verifying authentication\u2026" })
     ] });
@@ -92911,7 +92960,7 @@ async function runInit(flags, callbacks) {
   );
   await waitUntilExit();
 }
-var import_react39, import_jsx_runtime9, defaultInitScaffoldDependencies;
+var import_react39, import_jsx_runtime9, PROJECT_CREATION_AUTH_HANDOFF, INIT_AUTH_REASON_WITH_LICENSE, INIT_AUTH_REASON_ACCOUNT_ONLY, defaultInitScaffoldDependencies;
 var init_init = __esm({
   async "apps/cli/src/commands/init.tsx"() {
     "use strict";
@@ -92932,6 +92981,12 @@ var init_init = __esm({
     await init_spinner();
     init_config();
     import_jsx_runtime9 = __toESM(require_jsx_runtime(), 1);
+    PROJECT_CREATION_AUTH_HANDOFF = {
+      source: "cli",
+      mode: "project_creation"
+    };
+    INIT_AUTH_REASON_WITH_LICENSE = "Threads and other Intelligence features need a free license, which is issued to your CopilotKit account.";
+    INIT_AUTH_REASON_ACCOUNT_ONLY = "A free CopilotKit account is required to link this project.";
     defaultInitScaffoldDependencies = {
       verifyAndRefresh,
       login,
@@ -93469,7 +93524,7 @@ Commands:
   logout                 Clear local authentication
   whoami                 Show current authentication status
   docs                   Open CopilotKit documentation
-  init [options]         Initialize a new CopilotKit project
+  init [options]         Initialize a project and connect a workspace
   create [options]       Alias of init
   logs [options]         Show the CLI log path or recent log lines
   license                Issue a CopilotKit license key
@@ -93530,7 +93585,10 @@ Options:
   init: `Usage: copilotkit init [options]
        copilotkit create [options]
 
-Initialize a new CopilotKit project.
+Initialize a new CopilotKit project and connect it to a CopilotKit workspace
+through Ops/Clerk before scaffolding. Reuses an existing CLI session or opens
+browser sign-in when needed. License tokens are issued and written only for
+starters that require a license.
 
 Aliases:
   create                 Alias of init

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "copilotkit",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "type": "module",
   "bin": {
     "copilotkit": "./index.js"