@cargo-ai/cli 1.0.141 → 1.0.143

package/build/commands/docs.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from "commander";
+/** The same address the website links as its documentation. */
+export declare const DOCS_URL = "https://docs.getcargo.ai";
+export declare function registerDocsCommand(program: Command): void;
+//# sourceMappingURL=docs.d.ts.map

package/build/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,6BAA6B,CAAC;AAMnD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAe1D"}

package/build/commands/docs.js

@@ -0,0 +1,27 @@
+import { openBrowser } from "../utils/openBrowser.js";
+import { colors, info, outputJson } from "./runHandler.js";
+/** The same address the website links as its documentation. */
+export const DOCS_URL = "https://docs.getcargo.ai";
+export function registerDocsCommand(program) {
+    program
+        .command("docs")
+        .description("Open the Cargo documentation in your browser")
+        .option("--no-open", "Print the URL without launching a browser")
+        .addHelpText("after", `
+Examples:
+  $ cargo-ai docs
+  $ cargo-ai docs --no-open`)
+        .action((opts) => {
+        runDocs(opts);
+    });
+}
+function runDocs(opts) {
+    const opened = opts.open === true;
+    info("");
+    info(`The Cargo docs: ${colors.cyan(DOCS_URL)}`);
+    info("");
+    if (opened === true) {
+        openBrowser(DOCS_URL);
+    }
+    outputJson({ ok: true, url: DOCS_URL, opened });
+}

package/build/commands/signedOutNotice.d.ts

@@ -1,4 +1,4 @@
 export declare const SIGN_UP_COMMAND = "cargo-ai login --email you@company.com";
-export declare const SIGNED_OUT_NOTICE = "Not signed in: reading the official integrations and their actions only. Sign up with `cargo-ai login --email you@company.com` (100 free credits, no card) to run one.";
+export declare const SIGNED_OUT_NOTICE = "Not signed in: reading the official integrations and their actions only. Sign up with `cargo-ai login --email you@company.com` (100 free credits for your first month, no card) to run one.";
 export declare function noteSignedOut(): void;
 //# sourceMappingURL=signedOutNotice.d.ts.map

package/build/commands/signedOutNotice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signedOutNotice.d.ts","sourceRoot":"","sources":["../../src/commands/signedOutNotice.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,eAAe,2CAA2C,CAAC;AAExE,eAAO,MAAM,iBAAiB,2KAAyJ,CAAC;AAExL,wBAAgB,aAAa,IAAI,IAAI,CAIpC"}
+{"version":3,"file":"signedOutNotice.d.ts","sourceRoot":"","sources":["../../src/commands/signedOutNotice.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,eAAe,2CAA2C,CAAC;AAExE,eAAO,MAAM,iBAAiB,gMAA8K,CAAC;AAE7M,wBAAgB,aAAa,IAAI,IAAI,CAIpC"}

package/build/commands/signedOutNotice.js

@@ -3,7 +3,7 @@
 import { isSignedIn } from "@cargo-ai/cdk/cli";
 import { info } from "./runHandler.js";
 export const SIGN_UP_COMMAND = "cargo-ai login --email you@company.com";
-export const SIGNED_OUT_NOTICE = `Not signed in: reading the official integrations and their actions only. Sign up with \`${SIGN_UP_COMMAND}\` (100 free credits, no card) to run one.`;
+export const SIGNED_OUT_NOTICE = `Not signed in: reading the official integrations and their actions only. Sign up with \`${SIGN_UP_COMMAND}\` (100 free credits for your first month, no card) to run one.`;
 export function noteSignedOut() {
     if (isSignedIn() === false) {
         info(SIGNED_OUT_NOTICE);

package/build/commands/skills.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerSkillsCommands(program: Command): void;
+//# sourceMappingURL=skills.d.ts.map

package/build/commands/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsB7D"}

package/build/commands/skills.js

@@ -0,0 +1,32 @@
+import { installSkillsGlobally, SKILLS_INSTALL_COMMAND, skillsInstalledFor, } from "@cargo-ai/cdk/cli";
+import { failWith, info, outputJson } from "./runHandler.js";
+export function registerSkillsCommands(program) {
+    const skills = program
+        .command("skills")
+        .description("The Cargo skills, so your coding agent knows this CLI");
+    skills
+        .command("install")
+        .description("Install the Cargo skills for every coding agent here")
+        .addHelpText("after", `
+Installs the getcargohq/cargo-skills bundle for every coding agent on this
+machine (Claude Code, Codex, Cursor, …). Does nothing when this machine, or the
+project you are in, already has them. Running it is the consent: unlike the
+offer after sign-in, it does not ask first.
+
+Equivalent to:
+  $ ${SKILLS_INSTALL_COMMAND}`)
+        .action(() => {
+        runInstall();
+    });
+}
+function runInstall() {
+    if (skillsInstalledFor(process.cwd()) === true) {
+        info("The Cargo skills are already installed.");
+        outputJson({ ok: true, installed: true });
+        return;
+    }
+    if (installSkillsGlobally() === false) {
+        failWith(`Could not install the Cargo skills. Install them with: ${SKILLS_INSTALL_COMMAND}`);
+    }
+    outputJson({ ok: true, installed: true });
+}

package/build/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import { availableCodingAgents, BRAND, canRunPalette, creditsLeftOf, declareSources, fetchStateConnected, fetchSubscription, fetchWorkspaceName, findProjectDir, formatWorkspaceSuffix, isInteractive, isUnpaidPlan, printSetupIssues, registerCommands as registerCdkCommands, runPalette, SessionExpiredError, } from "@cargo-ai/cdk/cli";
+import { availableCodingAgents, BRAND, canRunPalette, creditsLeftOf, declareSources, fetchStateConnected, fetchSubscription, fetchWorkspaceName, findProjectDir, formatWorkspaceSuffix, isInteractive, isUnpaidPlan, printSetupIssues, registerCommands as registerCdkCommands, runPalette, SessionExpiredError, skillsInstalledFor, } from "@cargo-ai/cdk/cli";
 import { Command } from "commander";
 import { AGENT_SKILLS_HINT } from "./agentSkills.js";
 import { createApi } from "./api.js";
@@ -14,6 +14,7 @@ import { registerBookDemoCommand } from "./commands/bookDemo.js";
 import { registerConnectionCommands } from "./commands/connection/index.js";
 import { registerContentCommands } from "./commands/content/index.js";
 import { registerContextCommands } from "./commands/context/index.js";
+import { registerDocsCommand } from "./commands/docs.js";
 import { registerDoctorCommand } from "./commands/doctor.js";
 import { registerExpressionCommands } from "./commands/expression/index.js";
 import { registerHostingCommands } from "./commands/hosting/index.js";
@@ -24,6 +25,7 @@ import { registerOrchestrationCommands } from "./commands/orchestration/index.js
 import { registerRevenueOrganizationCommands } from "./commands/revenueOrganization/index.js";
 import { ExitCodes, failWith } from "./commands/runHandler.js";
 import { registerSegmentationCommands } from "./commands/segmentation/index.js";
+import { registerSkillsCommands } from "./commands/skills.js";
 import { registerStartCommand, runStart } from "./commands/start/index.js";
 import { loadStartState, shouldRunStart } from "./commands/start/state.js";
 import { registerStorageCommands } from "./commands/storage/index.js";
@@ -107,6 +109,9 @@ const SETUP_HEADER_SKIP = [
     "mcp",
     "ask",
     "book-demo",
+    "docs",
+    // The header's skills line would ask for the install this command runs.
+    "skills",
 ];
 /**
  * Say what is wrong before the command runs rather than after it fails, and
@@ -260,6 +265,8 @@ registerAuthCommands(program, getApi);
 registerVersionCommand(program, version);
 registerDoctorCommand(program, version);
 registerBookDemoCommand(program);
+registerDocsCommand(program);
+registerSkillsCommands(program);
 registerObservabilityCommands(program, getApi);
 registerOrchestrationCommands(program, getApi, getPublicApi);
 registerWorkspaceManagementCommands(program, getApi);
@@ -333,6 +340,8 @@ async function openPalette(startPath) {
             agents,
             projectDir: root,
             cwd,
+            // Re-read with the rest: picking "Install skills" is what changes it.
+            skillsInstalled: skillsInstalledFor(cwd),
             unpaidPlan: lookups.unpaidPlan,
             // Only trusted for the project it was asked about: a command can `cd`
             // the process or create a project, and an answer about another state

package/build/paletteLayout.d.ts

@@ -22,6 +22,11 @@ export type PaletteLayoutInput = {
      * row that fails when picked.
      */
     stateConnected?: boolean;
+    /**
+     * Whether a coding agent opened here would find the Cargo skills. True hides
+     * "Agent skills": a row that would only say "already installed".
+     */
+    skillsInstalled?: boolean;
 };
 export declare function buildPaletteLayout(input: PaletteLayoutInput): PaletteLayout;
 /**

package/build/paletteLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paletteLayout.d.ts","sourceRoot":"","sources":["../src/paletteLayout.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAgF3B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,mFAAmF;IACnF,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAS3E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAAE,CAmFjE"}
+{"version":3,"file":"paletteLayout.d.ts","sourceRoot":"","sources":["../src/paletteLayout.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAwH3B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,mFAAmF;IACnF,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAQ3E;AA2BD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAAE,CAmFjE"}

package/build/paletteLayout.js

@@ -37,16 +37,20 @@ const ENTRANCE = "start";
  * opens a menu of rows already on screen is a detour. `ask` is the same kind
  * of entrance — pinned as "Ask Cargo" — so drawing it again in the tree is a
  * second door to the same room. `version` is `--version`, and `doctor`
- * reports it anyway. `book-demo` is hidden only when it is pinned (see
- * `buildPaletteLayout`); otherwise it stays in the last section.
+ * reports it anyway. `login`, `logout`, `skills` and `book-demo` come and go
+ * with the session; see `hiddenRows`.
  */
 const HIDDEN = [ENTRANCE, "ask", "version"];
 /**
- * The sections, in reading order: everything the workspace is made of, then
- * the workspace as code on its own, then the machine you are sitting at —
- * which ends beside `/exit`, since leaving, checking your setup, and talking
- * to sales are the same kind of errand. What people reach for most is not
- * here at all; those are the pinned rows, above the first section.
+ * The sections, in reading order: the errands you run on your own setup —
+ * your account, the docs, the agent skills — then the workspace as code, then
+ * the command groups. What people reach for most is not here at all; those
+ * are the pinned rows, above the first section.
+ *
+ * The command groups come last because they are the reference shelf: each is
+ * a menu of its own, and nobody opening the palette starts by reading them
+ * all. The short rows above them would otherwise sit two screens down, beside
+ * `/exit`.
  *
  * Anything a release adds and nobody lists here still appears, in tree order,
  * in a final section — a new command is never invisible by omission. So a new
@@ -54,6 +58,12 @@ const HIDDEN = [ENTRANCE, "ask", "version"];
  * no entry to be reachable.
  */
 const SECTIONS = [
+    // Signed out, `login` and `logout` are both hidden behind the pinned Sign in,
+    // so `login` is only ever seen signed in, as "Switch account".
+    ["whoami", "login", "logout", "docs", "skills", "doctor", "book-demo"],
+    // The workspace as code sits on its own: it is the same resources again,
+    // declared in a repo rather than run from here.
+    ["project"],
     // Everything the workspace is: what you run, the data and connectors it runs
     // on, the knowledge it reads, and the surfaces it exposes. One group, most
     // used first — the divisions that used to be here were the CLI's own
@@ -78,20 +88,69 @@ const SECTIONS = [
         "user-management",
         "system-of-record",
     ],
-    // The workspace as code sits on its own: it is the same resources again,
-    // declared in a repo rather than run from here.
-    ["project"],
-    ["doctor", "whoami", "login", "logout", "book-demo"],
+];
+/**
+ * What each root row reads as. Command names are written for a shell
+ * (`mailboxManagement`, `system-of-record`); a menu row is read by a person.
+ * The slash name still filters (`/ai` finds "AI"), and a command missing here
+ * keeps its `/name`.
+ */
+const LABELS = [
+    { name: "whoami", label: "Who am I" },
+    { name: "login", label: "Switch account" },
+    { name: "logout", label: "Log out" },
+    { name: "docs", label: "Docs" },
+    { name: "skills", label: "Agent skills" },
+    { name: "doctor", label: "Check setup" },
+    { name: "book-demo", label: "Book a demo" },
+    { name: "project", label: "Project" },
+    { name: "orchestration", label: "Orchestration" },
+    { name: "storage", label: "Storage" },
+    { name: "connection", label: "Connections" },
+    { name: "segmentation", label: "Segmentation" },
+    { name: "ai", label: "AI" },
+    { name: "context", label: "Context" },
+    { name: "content", label: "Content" },
+    { name: "hosting", label: "Hosting" },
+    { name: "mcp", label: "MCP" },
+    { name: "mailboxManagement", label: "Mailboxes" },
+    { name: "workspaceManagement", label: "Workspace" },
+    { name: "billing", label: "Billing" },
+    { name: "observability", label: "Observability" },
+    { name: "revenue-organization", label: "Revenue organization" },
+    { name: "expression", label: "Expressions" },
+    { name: "user-management", label: "User" },
+    { name: "system-of-record", label: "Systems of record" },
 ];
 export function buildPaletteLayout(input) {
-    const pinBookDemo = input.signedIn === true && input.unpaidPlan === true;
     return {
         pinned: pinnedRows(input),
-        hide: pinBookDemo === true ? [...HIDDEN, "book-demo"] : HIDDEN,
+        hide: hiddenRows(input),
         sections: SECTIONS,
+        labels: LABELS,
         placeholder: "type to filter, or ask a question",
     };
 }
+/**
+ * `HIDDEN`, plus the rows this session makes pointless. Signed out, there is
+ * nothing to log out of, and the pinned "Sign in" is the way in — it carries
+ * on into the rest of the setup, which a bare `login` does not. "Agent skills"
+ * goes once they are installed (installing is all the group does), and "Book a
+ * demo" is hidden here only when it is pinned.
+ */
+function hiddenRows(input) {
+    const hidden = [...HIDDEN];
+    if (input.signedIn === false) {
+        hidden.push("login", "logout");
+    }
+    if (input.skillsInstalled === true) {
+        hidden.push("skills");
+    }
+    if (input.signedIn === true && input.unpaidPlan === true) {
+        hidden.push("book-demo");
+    }
+    return hidden;
+}
 /**
  * The rows above the rule. Signed out there is exactly one thing worth
  * offering, and it is not a list of twenty command groups that all exit 3.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cli",
-  "version": "1.0.141",
+  "version": "1.0.143",
   "mcpName": "io.github.getcargohq/cargo",
   "private": false,
   "license": "UNLICENSED",
@@ -74,11 +74,11 @@
   "dependencies": {
     "@ai-sdk/harness": "1.0.144",
     "@ai-sdk/harness-claude-code": "1.0.148",
-    "@cargo-ai/api": "^1.0.106",
+    "@cargo-ai/api": "^1.0.107",
     "@cargo-ai/app-sdk": "^1.0.11",
-    "@cargo-ai/cdk": "^1.0.135",
-    "@cargo-ai/types": "^1.0.105",
-    "@cargo-ai/utils": "^1.0.35",
+    "@cargo-ai/cdk": "^1.0.137",
+    "@cargo-ai/types": "^1.0.106",
+    "@cargo-ai/utils": "^1.0.37",
     "@cargo-ai/worker-sdk": "^1.0.21",
     "@modelcontextprotocol/sdk": "^1.32.0",
     "ai": "^7.0.133",