@braid-cloud/cli 0.1.8 → 0.1.10

package/dist/index.js

@@ -322,7 +322,7 @@ var init_config = __esm({
 
 // src/lib/api.ts
 import { Data as Data2, Effect as Effect2, pipe as pipe2 } from "effect";
-var TRAILING_SLASH_REGEX, ApiError, AuthenticationError, NetworkError, resolveApiKey, resolveServerUrl, parseResponse, buildApiUrl, buildExportUrl, executeApiRequest, parseScopeOptionsResponse, fetchScopeOptions, buildRuleOptionsUrl, fetchRuleOptions, fetchSkills, validateApiKey, fetchSkillsAsync, validateApiKeyAsync, fetchScopeOptionsAsync, fetchRuleOptionsAsync;
+var TRAILING_SLASH_REGEX, ApiError, AuthenticationError, NetworkError, resolveApiKey, resolveServerUrl, parseResponse, buildApiUrl, buildExportUrl, executeApiRequest, parseScopeOptionsResponse, fetchScopeOptions, buildRuleOptionsUrl, fetchRuleOptions, fetchSkills, runLifecycleCommand, DEFAULT_PUBLIC_SERVER_URL, NotFoundError, RateLimitedError, handlePublicApiResponse, fetchPublicMetadata, fetchPublicExport, fetchPublicMetadataAsync, fetchPublicExportAsync, validateApiKey, fetchSkillsAsync, validateApiKeyAsync, fetchScopeOptionsAsync, fetchRuleOptionsAsync, runLifecycleCommandAsync;
 var init_api = __esm({
   "src/lib/api.ts"() {
     "use strict";
@@ -579,6 +579,145 @@ var init_api = __esm({
         return executeApiRequest(url, apiKey, serverUrl);
       })
     );
+    runLifecycleCommand = (request, options = {}) => pipe2(
+      Effect2.all({
+        apiKey: resolveApiKey(options.apiKey),
+        serverUrl: resolveServerUrl(options.serverUrl)
+      }),
+      Effect2.flatMap(
+        ({ apiKey, serverUrl }) => Effect2.tryPromise({
+          try: async () => {
+            const response = await fetch(
+              buildApiUrl(serverUrl, "/api/lifecycle").toString(),
+              {
+                method: "POST",
+                headers: {
+                  Authorization: `Bearer ${apiKey}`,
+                  "Content-Type": "application/json"
+                },
+                body: JSON.stringify(request)
+              }
+            );
+            const json = await response.json();
+            if (!response.ok) {
+              const errorResponse = json;
+              if (response.status === 401) {
+                throw new AuthenticationError({
+                  message: errorResponse.error || "Invalid or expired API key. Run 'braid auth' to re-authenticate."
+                });
+              }
+              throw new ApiError({
+                message: errorResponse.error || "API request failed",
+                code: errorResponse.code || "UNKNOWN_ERROR",
+                status: response.status
+              });
+            }
+            return json;
+          },
+          catch: (error) => {
+            if (error instanceof ApiError || error instanceof AuthenticationError || error instanceof NetworkError) {
+              return error;
+            }
+            return new NetworkError({
+              message: `Failed to connect to ${serverUrl}`,
+              cause: error
+            });
+          }
+        })
+      )
+    );
+    DEFAULT_PUBLIC_SERVER_URL = "https://braid.cloud";
+    NotFoundError = class extends Data2.TaggedError("NotFoundError") {
+    };
+    RateLimitedError = class extends Data2.TaggedError("RateLimitedError") {
+    };
+    handlePublicApiResponse = (response, json) => {
+      if (response.ok) {
+        return Effect2.succeed(json);
+      }
+      if (response.status === 404) {
+        return Effect2.fail(
+          new NotFoundError({ message: "Public content not found" })
+        );
+      }
+      if (response.status === 429) {
+        const retryAfter = response.headers.get("Retry-After");
+        const retryMs = retryAfter ? Number(retryAfter) * 1e3 : null;
+        return Effect2.fail(
+          new RateLimitedError({
+            message: "Rate limited. Please try again later.",
+            ...retryMs !== null ? { retryAfterMs: retryMs } : {}
+          })
+        );
+      }
+      const errorResponse = json;
+      return Effect2.fail(
+        new ApiError({
+          message: errorResponse.error || "API request failed",
+          code: errorResponse.code || "UNKNOWN_ERROR",
+          status: response.status
+        })
+      );
+    };
+    fetchPublicMetadata = (handle, slug, serverUrl) => {
+      const baseUrl = (serverUrl ?? DEFAULT_PUBLIC_SERVER_URL).replace(
+        TRAILING_SLASH_REGEX,
+        ""
+      );
+      const url = `${baseUrl}/api/public/@${handle}/${slug}`;
+      return pipe2(
+        Effect2.tryPromise({
+          try: () => fetch(url, { method: "GET" }),
+          catch: (e) => new NetworkError({
+            message: `Failed to connect to ${baseUrl}`,
+            cause: e
+          })
+        }),
+        Effect2.flatMap(
+          (response) => pipe2(
+            Effect2.tryPromise({
+              try: () => response.json(),
+              catch: () => new NetworkError({ message: "Failed to parse API response" })
+            }),
+            Effect2.flatMap(
+              (json) => handlePublicApiResponse(response, json)
+            )
+          )
+        )
+      );
+    };
+    fetchPublicExport = (handle, slug, ruleIds, serverUrl) => {
+      const baseUrl = (serverUrl ?? DEFAULT_PUBLIC_SERVER_URL).replace(
+        TRAILING_SLASH_REGEX,
+        ""
+      );
+      const url = new URL(`${baseUrl}/api/public/@${handle}/${slug}/export`);
+      if (ruleIds && ruleIds.length > 0) {
+        url.searchParams.set("ruleIds", ruleIds.join(","));
+      }
+      return pipe2(
+        Effect2.tryPromise({
+          try: () => fetch(url.toString(), { method: "GET" }),
+          catch: (e) => new NetworkError({
+            message: `Failed to connect to ${baseUrl}`,
+            cause: e
+          })
+        }),
+        Effect2.flatMap(
+          (response) => pipe2(
+            Effect2.tryPromise({
+              try: () => response.json(),
+              catch: () => new NetworkError({ message: "Failed to parse API response" })
+            }),
+            Effect2.flatMap(
+              (json) => handlePublicApiResponse(response, json)
+            )
+          )
+        )
+      );
+    };
+    fetchPublicMetadataAsync = (handle, slug, serverUrl) => Effect2.runPromise(fetchPublicMetadata(handle, slug, serverUrl));
+    fetchPublicExportAsync = (handle, slug, ruleIds, serverUrl) => Effect2.runPromise(fetchPublicExport(handle, slug, ruleIds, serverUrl));
     validateApiKey = (apiKey, serverUrl) => pipe2(
       Effect2.tryPromise({
         try: async () => {
@@ -604,6 +743,7 @@ var init_api = __esm({
     validateApiKeyAsync = (apiKey, serverUrl) => Effect2.runPromise(validateApiKey(apiKey, serverUrl));
     fetchScopeOptionsAsync = (options = {}) => Effect2.runPromise(fetchScopeOptions(options));
     fetchRuleOptionsAsync = (options = {}) => Effect2.runPromise(fetchRuleOptions(options));
+    runLifecycleCommandAsync = (request, options = {}) => Effect2.runPromise(runLifecycleCommand(request, options));
   }
 });
 
@@ -922,10 +1062,10 @@ async function selectProjects(organizationContext, scopeOptions) {
   }
   return selected.length > 0 ? selected : void 0;
 }
-async function pickRuleIds(message, rules) {
+async function pickRuleIds(message, rules2) {
   const selected = await multiselect({
     message,
-    options: rules.map((rule) => ({
+    options: rules2.map((rule) => ({
       value: rule.id,
       label: rule.title,
       hint: rule.id
@@ -1191,7 +1331,7 @@ async function authCommand(options) {
       return;
     }
   }
-  const apiKey = await password({
+  const apiKey = options.token ? options.token : await password({
     message: "Enter your braid API key:",
     validate: (value) => {
       if (!value) {
@@ -1233,7 +1373,9 @@ async function authCommand(options) {
       await saveUserConfigAsync({ ...existingUserConfig, token: apiKey });
     }
     stopAuthSpinner("API key validated and saved");
-    await configureDefaultScopeAsync(serverUrl);
+    if (options.scope !== false) {
+      await configureDefaultScopeAsync(serverUrl);
+    }
     log.success(`Config saved to ${CONFIG_FILE}`);
     outro(
       "You're authenticated! Run 'braid install --profile <name>' to install skills."
@@ -1301,6 +1443,142 @@ async function authLogoutCommand() {
   log.success("Logged out. API key removed from config.");
 }
 
+// src/commands/discover.ts
+init_esm_shims();
+init_api();
+init_config();
+init_tui();
+import process6 from "process";
+var parseCsv = (input) => {
+  if (!input) {
+    return void 0;
+  }
+  const values = input.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
+  return values.length > 0 ? values : void 0;
+};
+var writeJson = (value) => {
+  process6.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+};
+var exitWithError = (error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  log.error(message);
+  process6.exit(1);
+};
+var applyCommonOptions = (base, options) => ({
+  ...base,
+  ...options.server ? { serverUrl: options.server } : {},
+  ...options.apiKey ? { apiKey: options.apiKey } : {}
+});
+var applyOptionalString = (target, key, value) => {
+  if (value) {
+    target[key] = value;
+  }
+};
+var applyOptionalArray = (target, key, value) => {
+  if (value && value.length > 0) {
+    target[key] = value;
+  }
+};
+var applyOptionalBoolean = (target, key, value) => {
+  if (value !== void 0) {
+    target[key] = value;
+  }
+};
+async function projectsListCommand(options) {
+  try {
+    const result = await fetchScopeOptionsAsync(
+      applyCommonOptions({}, options)
+    );
+    if (options.json) {
+      writeJson(result);
+      return;
+    }
+    log.info("Personal projects:");
+    if (result.personalProjects.length === 0) {
+      log.info("  (none)");
+    }
+    for (const project of result.personalProjects) {
+      log.info(`  ${project.id}  ${project.name}`);
+    }
+    for (const orgProjects of result.orgProjects) {
+      log.info(`
+Organization: ${orgProjects.orgName} (${orgProjects.orgId})`);
+      if (orgProjects.projects.length === 0) {
+        log.info("  (none)");
+        continue;
+      }
+      for (const project of orgProjects.projects) {
+        log.info(`  ${project.id}  ${project.name}`);
+      }
+    }
+  } catch (error) {
+    exitWithError(error);
+  }
+}
+var buildRulesRequest = async (options) => {
+  const config = await loadMergedConfigAsync();
+  const orgProjects = parseCsv(options.orgProjects) ?? config.orgProjects;
+  const personalProjects = parseCsv(options.personalProjects) ?? config.personalProjects;
+  const request = applyCommonOptions({}, options);
+  applyOptionalString(request, "orgId", options.orgId ?? config.org);
+  applyOptionalArray(request, "orgProjects", orgProjects);
+  applyOptionalArray(request, "personalProjects", personalProjects);
+  applyOptionalBoolean(request, "includeUserGlobal", options.includeUserGlobal);
+  applyOptionalBoolean(request, "includeOrgGlobal", options.includeOrgGlobal);
+  return request;
+};
+async function rulesListCommand(options) {
+  try {
+    const result = await fetchRuleOptionsAsync(
+      await buildRulesRequest(options)
+    );
+    if (options.json) {
+      writeJson(result);
+      return;
+    }
+    if (result.rules.length === 0) {
+      log.info("No rules found.");
+      return;
+    }
+    for (const rule of result.rules) {
+      log.info(`${rule.id}  ${rule.title}`);
+    }
+  } catch (error) {
+    exitWithError(error);
+  }
+}
+var buildSkillsRequest = async (options) => {
+  const config = await loadMergedConfigAsync();
+  const orgProjects = parseCsv(options.orgProjects) ?? config.orgProjects;
+  const personalProjects = parseCsv(options.personalProjects) ?? config.personalProjects;
+  const request = applyCommonOptions({}, options);
+  applyOptionalString(request, "profile", options.profile ?? config.profile);
+  applyOptionalArray(request, "orgProjects", orgProjects);
+  applyOptionalArray(request, "personalProjects", personalProjects);
+  applyOptionalBoolean(request, "includeUserGlobal", options.includeUserGlobal);
+  applyOptionalBoolean(request, "includeOrgGlobal", options.includeOrgGlobal);
+  return request;
+};
+async function skillsListCommand(options) {
+  try {
+    const result = await fetchSkillsAsync(await buildSkillsRequest(options));
+    if (options.json) {
+      writeJson(result);
+      return;
+    }
+    if (result.skills.length === 0) {
+      log.info("No skills found.");
+      return;
+    }
+    for (const skill of result.skills) {
+      log.info(`${skill.name}`);
+    }
+  } catch (error) {
+    exitWithError(error);
+  }
+}
+
 // src/commands/install.ts
 init_esm_shims();
 
@@ -1309,11 +1587,11 @@ init_esm_shims();
 import { access, constants } from "fs/promises";
 import { homedir as homedir2 } from "os";
 import { join as join2 } from "path";
-import process6 from "process";
+import process7 from "process";
 import { Effect as Effect3, pipe as pipe3 } from "effect";
 var home = homedir2();
 var vscodeExtSettingsPath = (extensionId, filename) => {
-  if (process6.platform === "darwin") {
+  if (process7.platform === "darwin") {
     return join2(
       home,
       "Library",
@@ -1326,8 +1604,8 @@ var vscodeExtSettingsPath = (extensionId, filename) => {
       filename
     );
   }
-  if (process6.platform === "win32") {
-    const appData = process6.env.APPDATA ?? join2(home, "AppData", "Roaming");
+  if (process7.platform === "win32") {
+    const appData = process7.env.APPDATA ?? join2(home, "AppData", "Roaming");
     return join2(
       appData,
       "Code",
@@ -1350,7 +1628,7 @@ var vscodeExtSettingsPath = (extensionId, filename) => {
   );
 };
 var claudeDesktopConfigPath = () => {
-  if (process6.platform === "darwin") {
+  if (process7.platform === "darwin") {
     return join2(
       home,
       "Library",
@@ -1359,8 +1637,8 @@ var claudeDesktopConfigPath = () => {
       "claude_desktop_config.json"
     );
   }
-  if (process6.platform === "win32") {
-    const appData = process6.env.APPDATA ?? join2(home, "AppData", "Roaming");
+  if (process7.platform === "win32") {
+    const appData = process7.env.APPDATA ?? join2(home, "AppData", "Roaming");
     return join2(appData, "Claude", "claude_desktop_config.json");
   }
   return join2(home, ".config", "Claude", "claude_desktop_config.json");
@@ -1685,7 +1963,7 @@ var directoryExists = (path2) => pipe3(
   Effect3.orElseSucceed(() => false)
 );
 var detectAgents = (projectRoot) => {
-  const cwd = projectRoot ?? process6.cwd();
+  const cwd = projectRoot ?? process7.cwd();
   return pipe3(
     Effect3.forEach(
       AGENTS,
@@ -1730,7 +2008,7 @@ var resolveInstallPath = (agent, options) => {
   if (!agent.projectPath) {
     return void 0;
   }
-  const cwd = options.projectRoot ?? process6.cwd();
+  const cwd = options.projectRoot ?? process7.cwd();
   return join2(cwd, agent.projectPath);
 };
 var resolveRulesInstallPath = (agent, options) => {
@@ -1740,7 +2018,7 @@ var resolveRulesInstallPath = (agent, options) => {
   if (!agent.rulesProjectPath) {
     return void 0;
   }
-  const cwd = options.projectRoot ?? process6.cwd();
+  const cwd = options.projectRoot ?? process7.cwd();
   return join2(cwd, agent.rulesProjectPath);
 };
 var hasMcpConfig = (agent) => Boolean(agent.mcpProjectConfigPath) || Boolean(agent.mcpGlobalConfigPath);
@@ -1749,7 +2027,7 @@ var resolveMcpConfigPath = (agent, options) => {
     return agent.mcpGlobalConfigPath;
   }
   if (agent.mcpProjectConfigPath) {
-    const cwd = options.projectRoot ?? process6.cwd();
+    const cwd = options.projectRoot ?? process7.cwd();
     return join2(cwd, agent.mcpProjectConfigPath);
   }
   return agent.mcpGlobalConfigPath;
@@ -1908,9 +2186,9 @@ function buildMdcContent(rule) {
   lines.push(rule.content);
   return lines.join("\n");
 }
-function buildAppendContent(rules) {
+function buildAppendContent(rules2) {
   const lines = [BRAID_SECTION_START, ""];
-  for (const rule of rules) {
+  for (const rule of rules2) {
     lines.push(`## ${rule.title}`);
     lines.push("");
     lines.push(rule.content);
@@ -1919,11 +2197,11 @@ function buildAppendContent(rules) {
   lines.push(BRAID_SECTION_END);
   return lines.join("\n");
 }
-var writeMdcRules = (basePath, rules) => pipe5(
+var writeMdcRules = (basePath, rules2) => pipe5(
   createDirectory(basePath),
   Effect5.flatMap(
     () => Effect5.forEach(
-      rules,
+      rules2,
       (rule) => pipe5(
         assertRulePathWithinBase(basePath, `${rule.name}.mdc`),
         Effect5.flatMap(
@@ -1935,11 +2213,11 @@ var writeMdcRules = (basePath, rules) => pipe5(
   ),
   Effect5.asVoid
 );
-var writeMarkdownDirRules = (basePath, rules) => pipe5(
+var writeMarkdownDirRules = (basePath, rules2) => pipe5(
   createDirectory(basePath),
   Effect5.flatMap(
     () => Effect5.forEach(
-      rules,
+      rules2,
       (rule) => pipe5(
         assertRulePathWithinBase(basePath, `${rule.name}.md`),
         Effect5.flatMap(
@@ -1953,7 +2231,7 @@ ${rule.content}`)
   ),
   Effect5.asVoid
 );
-var writeAppendSingleRules = (filePath, rules) => pipe5(
+var writeAppendSingleRules = (filePath, rules2) => pipe5(
   createDirectory(dirname2(filePath)),
   Effect5.flatMap(
     () => pipe5(
@@ -1962,7 +2240,7 @@ var writeAppendSingleRules = (filePath, rules) => pipe5(
     )
   ),
   Effect5.flatMap((existing) => {
-    const braidContent = buildAppendContent(rules);
+    const braidContent = buildAppendContent(rules2);
     const startIdx = existing.indexOf(BRAID_SECTION_START);
     const endIdx = existing.indexOf(BRAID_SECTION_END);
     let newContent;
@@ -1976,26 +2254,26 @@ ${braidContent}` : braidContent;
     return writeTextFile(filePath, newContent);
   })
 );
-var writeRulesForFormat = (basePath, rules, format) => {
+var writeRulesForFormat = (basePath, rules2, format) => {
   switch (format) {
     case "mdc":
-      return writeMdcRules(basePath, rules);
+      return writeMdcRules(basePath, rules2);
     case "markdown-dir":
-      return writeMarkdownDirRules(basePath, rules);
+      return writeMarkdownDirRules(basePath, rules2);
     case "append-single":
-      return writeAppendSingleRules(basePath, rules);
+      return writeAppendSingleRules(basePath, rules2);
     default:
       return Effect5.void;
   }
 };
-var writeRulesForAgent = (agent, rules, rulesPath) => {
-  if (!agent.ruleFormat || rules.length === 0) {
+var writeRulesForAgent = (agent, rules2, rulesPath) => {
+  if (!agent.ruleFormat || rules2.length === 0) {
     return Effect5.succeed({ written: 0, errors: [] });
   }
   return pipe5(
-    writeRulesForFormat(rulesPath, rules, agent.ruleFormat),
+    writeRulesForFormat(rulesPath, rules2, agent.ruleFormat),
     Effect5.map(() => ({
-      written: rules.length,
+      written: rules2.length,
       errors: []
     })),
     Effect5.catchAll(
@@ -2011,7 +2289,7 @@ var writeRulesForAgent = (agent, rules, rulesPath) => {
     )
   );
 };
-var writeRulesForAgentAsync = (agent, rules, rulesPath) => Effect5.runPromise(writeRulesForAgent(agent, rules, rulesPath));
+var writeRulesForAgentAsync = (agent, rules2, rulesPath) => Effect5.runPromise(writeRulesForAgent(agent, rules2, rulesPath));
 
 // src/lib/skill-writer.ts
 init_esm_shims();
@@ -2120,9 +2398,9 @@ var writeSkill = (basePath, skill, agentId) => pipe6(
     )
   )
 );
-var writeSkills = (basePath, skills, agentId) => pipe6(
+var writeSkills = (basePath, skills2, agentId) => pipe6(
   Effect6.forEach(
-    skills,
+    skills2,
     (skill) => pipe6(
       writeSkill(basePath, skill, agentId),
       Effect6.map(() => ({ success: true, skill: skill.name })),
@@ -2143,7 +2421,7 @@ var writeSkills = (basePath, skills, agentId) => pipe6(
     ).map((r) => ({ skill: r.skill, error: r.error }))
   }))
 );
-var writeSkillsAsync = (basePath, skills, agentId) => Effect6.runPromise(writeSkills(basePath, skills, agentId));
+var writeSkillsAsync = (basePath, skills2, agentId) => Effect6.runPromise(writeSkills(basePath, skills2, agentId));
 
 // src/commands/install.ts
 init_tui();
@@ -2220,9 +2498,9 @@ function buildFetchOptions(resolved) {
   }
   return fetchOptions;
 }
-function displaySkillsAndExit(skills) {
+function displaySkillsAndExit(skills2) {
   log.info("\nSkills:");
-  for (const skill of skills) {
+  for (const skill of skills2) {
     const fileCount = skill.files.length;
     log.info(
       `  ${skill.name} (${fileCount} file${fileCount !== 1 ? "s" : ""})`
@@ -2330,14 +2608,14 @@ async function installSkillsToAgent(agent, response, installPath) {
   return { written: result.written.length, errors: result.errors.length };
 }
 async function installRulesToAgent(agent, response, options) {
-  const rules = response.rules ?? [];
+  const rules2 = response.rules ?? [];
   const rulesPath = resolveRulesInstallPath(agent, {
     global: options.global === true
   });
-  if (rules.length === 0 || !rulesPath || !agent.ruleFormat) {
+  if (rules2.length === 0 || !rulesPath || !agent.ruleFormat) {
     return { written: 0, errors: 0 };
   }
-  const result = await writeRulesForAgentAsync(agent, rules, rulesPath);
+  const result = await writeRulesForAgentAsync(agent, rules2, rulesPath);
   for (const err of result.errors) {
     log.warn(`  Failed rules: ${err.agent} - ${err.error}`);
   }
@@ -2358,17 +2636,17 @@ async function installToAgent(agent, response, serverUrl, options, installSpinne
     global: options.global === true
   });
   installSpinner.start(`Installing to ${agent.name}...`);
-  const skills = installPath ? await installSkillsToAgent(agent, response, installPath) : { written: 0, errors: 0 };
-  const rules = await installRulesToAgent(agent, response, options);
-  const totalWritten = skills.written + rules.written;
-  const totalErrors = skills.errors + rules.errors;
+  const skills2 = installPath ? await installSkillsToAgent(agent, response, installPath) : { written: 0, errors: 0 };
+  const rules2 = await installRulesToAgent(agent, response, options);
+  const totalWritten = skills2.written + rules2.written;
+  const totalErrors = skills2.errors + rules2.errors;
   if (totalErrors > 0) {
     installSpinner.stop(
       `${agent.name}: ${totalWritten} installed, ${totalErrors} failed`
     );
   } else {
     installSpinner.stop(
-      formatInstallSummary(agent.name, skills.written, rules.written)
+      formatInstallSummary(agent.name, skills2.written, rules2.written)
     );
   }
   if (response.skills.length > 0 && installPath) {
@@ -2384,7 +2662,180 @@ async function installToAgent(agent, response, serverUrl, options, installSpinne
   }
   return { written: totalWritten, errors: totalErrors };
 }
-async function installCommand(options) {
+var PUBLIC_SOURCE_REGEX = /^@([a-z0-9-]+)\/([a-z0-9-]+)$/;
+function parsePublicSource(source) {
+  const match = source.match(PUBLIC_SOURCE_REGEX);
+  if (!(match?.[1] && match[2])) {
+    return null;
+  }
+  return { handle: match[1], slug: match[2] };
+}
+function displayPublicMetadata(metadata) {
+  if (metadata.type === "project") {
+    const { project, rules: rules2 } = metadata;
+    log.info(`
+Project: ${project.name}`);
+    if (project.description) {
+      log.info(`  ${project.description}`);
+    }
+    log.info(`  ${rules2.length} rule(s) available`);
+  } else {
+    const { rule } = metadata;
+    log.info(`
+Rule: ${rule.title}`);
+    log.info(`  Type: ${rule.type}`);
+    if (rule.tags.length > 0) {
+      log.info(`  Tags: ${rule.tags.join(", ")}`);
+    }
+    if (rule.description) {
+      log.info(`  ${rule.description}`);
+    }
+  }
+}
+async function selectPublicRules(metadata, options) {
+  if (metadata.type !== "project") {
+    return null;
+  }
+  if (options.yes) {
+    return metadata.rules.map((r) => r.id);
+  }
+  const selected = await multiselect({
+    message: "Select rules to install:",
+    options: metadata.rules.map((r) => ({
+      value: r.id,
+      label: r.title,
+      hint: r.type
+    })),
+    initialValues: metadata.rules.map((r) => r.id),
+    required: true
+  });
+  if (isCancel(selected)) {
+    cancel("Install cancelled.");
+    process.exit(0);
+  }
+  return selected;
+}
+async function confirmRuleInstall(metadata, options) {
+  if (metadata.type !== "rule") {
+    return true;
+  }
+  if (options.yes) {
+    return true;
+  }
+  const confirmed = await confirm({
+    message: `Install "${metadata.rule.title}"?`
+  });
+  if (isCancel(confirmed)) {
+    cancel("Install cancelled.");
+    process.exit(0);
+  }
+  return confirmed === true;
+}
+function summarizeContent(response) {
+  const ruleCount = response.rules?.length ?? 0;
+  const skillCount = response.skills.length;
+  const parts = [];
+  if (skillCount > 0) {
+    parts.push(`${skillCount} skills`);
+  }
+  if (ruleCount > 0) {
+    parts.push(`${ruleCount} rules`);
+  }
+  return parts.join(", ") || "nothing";
+}
+function hasNoContent(response) {
+  return response.skills.length === 0 && (response.rules?.length ?? 0) === 0;
+}
+async function installToSelectedAgents(response, serverUrl, options, installSpinner) {
+  const agentResolution = await resolveAgents(options, installSpinner);
+  const selectedAgents = await selectAgents(
+    agentResolution.availableAgents,
+    agentResolution.preselectedAgents,
+    options
+  );
+  let totalWritten = 0;
+  let totalErrors = 0;
+  for (const agent of selectedAgents) {
+    const result = await installToAgent(
+      agent,
+      response,
+      serverUrl,
+      options,
+      installSpinner
+    );
+    totalWritten += result.written;
+    totalErrors += result.errors;
+  }
+  return { totalWritten, totalErrors };
+}
+function showInstallOutro(totalWritten, totalErrors, suffix) {
+  if (totalErrors > 0) {
+    outro(`Installed ${totalWritten} items with ${totalErrors} errors.`);
+  } else {
+    outro(`Successfully installed ${totalWritten} items${suffix}.`);
+  }
+}
+async function fetchPublicContent(handle, slug, options, installSpinner) {
+  const metadata = await fetchPublicMetadataAsync(handle, slug, options.server);
+  installSpinner.stop("Found public content");
+  displayPublicMetadata(metadata);
+  let ruleIds;
+  if (metadata.type === "project") {
+    const selected = await selectPublicRules(metadata, options);
+    ruleIds = selected ?? void 0;
+  } else {
+    const confirmed = await confirmRuleInstall(metadata, options);
+    if (!confirmed) {
+      outro("Install cancelled.");
+      process.exit(0);
+    }
+  }
+  installSpinner.start("Downloading content...");
+  return fetchPublicExportAsync(handle, slug, ruleIds, options.server);
+}
+async function publicInstallCommand(source, options) {
+  const parsed = parsePublicSource(source);
+  if (!parsed) {
+    log.error(`Invalid public source: ${source}`);
+    log.info("Expected format: @handle/slug (e.g., @acme/coding-standards)");
+    process.exit(1);
+  }
+  const { handle, slug } = parsed;
+  intro(`Installing from @${handle}/${slug}`);
+  const installSpinner = spinner();
+  installSpinner.start("Fetching public content...");
+  try {
+    const response = await fetchPublicContent(
+      handle,
+      slug,
+      options,
+      installSpinner
+    );
+    installSpinner.stop(`Downloaded ${summarizeContent(response)}`);
+    if (hasNoContent(response)) {
+      log.warn("No content to install.");
+      process.exit(0);
+    }
+    const serverUrl = options.server ?? "https://braid.cloud";
+    const { totalWritten, totalErrors } = await installToSelectedAgents(
+      response,
+      serverUrl,
+      options,
+      installSpinner
+    );
+    showInstallOutro(totalWritten, totalErrors, ` from @${handle}/${slug}`);
+  } catch (error) {
+    installSpinner.stop("Install failed");
+    const message = error instanceof Error ? error.message : String(error);
+    log.error(message);
+    process.exit(1);
+  }
+}
+async function installCommand(sourceOrOptions, maybeOptions) {
+  if (typeof sourceOrOptions === "string") {
+    return handlePublicSource(sourceOrOptions, maybeOptions ?? {});
+  }
+  const options = sourceOrOptions;
   const config = await loadMergedConfigAsync();
   const resolved = resolveInstallConfig(options, config);
   validateInstallOptions(resolved);
@@ -2395,17 +2846,8 @@ async function installCommand(options) {
   try {
     const fetchOptions = buildFetchOptions(resolved);
     const response = await fetchSkillsAsync(fetchOptions);
-    const ruleCount = response.rules?.length ?? 0;
-    const skillCount = response.skills.length;
-    const foundParts = [];
-    if (skillCount > 0) {
-      foundParts.push(`${skillCount} skills`);
-    }
-    if (ruleCount > 0) {
-      foundParts.push(`${ruleCount} rules`);
-    }
-    installSpinner.stop(`Found ${foundParts.join(", ") || "nothing"}`);
-    if (skillCount === 0 && ruleCount === 0) {
+    installSpinner.stop(`Found ${summarizeContent(response)}`);
+    if (hasNoContent(response)) {
       log.warn(
         "No skills or rules found. Check that your profile/project has enabled prompts."
       );
@@ -2414,32 +2856,13 @@ async function installCommand(options) {
     if (options.list) {
       displaySkillsAndExit(response.skills);
     }
-    const agentResolution = await resolveAgents(options, installSpinner);
-    const selectedAgents = await selectAgents(
-      agentResolution.availableAgents,
-      agentResolution.preselectedAgents,
-      options
+    const { totalWritten, totalErrors } = await installToSelectedAgents(
+      response,
+      resolved.serverUrl,
+      options,
+      installSpinner
     );
-    let totalWritten = 0;
-    let totalErrors = 0;
-    for (const agent of selectedAgents) {
-      const result = await installToAgent(
-        agent,
-        response,
-        resolved.serverUrl,
-        options,
-        installSpinner
-      );
-      totalWritten += result.written;
-      totalErrors += result.errors;
-    }
-    if (totalErrors > 0) {
-      outro(`Installed ${totalWritten} items with ${totalErrors} errors.`);
-    } else {
-      outro(
-        `Successfully installed ${totalWritten} items to ${selectedAgents.length} agent(s).`
-      );
-    }
+    showInstallOutro(totalWritten, totalErrors, ` to ${totalWritten} agent(s)`);
     log.info("Run 'braid list' to see installed skills.");
   } catch (error) {
     installSpinner.stop("Install failed");
@@ -2448,6 +2871,15 @@ async function installCommand(options) {
     process.exit(1);
   }
 }
+function handlePublicSource(source, options) {
+  const publicParsed = parsePublicSource(source);
+  if (publicParsed) {
+    return publicInstallCommand(source, options);
+  }
+  log.error(`Unknown source: ${source}`);
+  log.info("Public sources use format: @handle/slug");
+  process.exit(1);
+}
 
 // src/commands/list.ts
 init_esm_shims();
@@ -2545,7 +2977,7 @@ async function listCommand(options) {
 
 // src/commands/mcp.ts
 init_esm_shims();
-import process7 from "process";
+import process8 from "process";
 init_config();
 
 // src/lib/mcp-config.ts
@@ -2630,7 +3062,7 @@ async function selectTool(mcpAgents, toolFlag) {
     if (!agent) {
       log.error(`Unknown or unsupported tool: ${toolFlag}`);
       log.info(`Supported tools: ${mcpAgents.map((a) => a.id).join(", ")}`);
-      process7.exit(1);
+      process8.exit(1);
     }
     return agent;
   }
@@ -2649,12 +3081,12 @@ async function selectTool(mcpAgents, toolFlag) {
   });
   if (isCancel(toolChoice)) {
     cancel("MCP setup cancelled.");
-    process7.exit(0);
+    process8.exit(0);
   }
   const found = mcpAgents.find((a) => a.id === toolChoice);
   if (!found) {
     log.error("Agent not found.");
-    process7.exit(1);
+    process8.exit(1);
   }
   return found;
 }
@@ -2680,7 +3112,7 @@ async function selectScope(agent, options) {
   });
   if (isCancel(scopeChoice)) {
     cancel("MCP setup cancelled.");
-    process7.exit(0);
+    process8.exit(0);
   }
   return scopeChoice;
 }
@@ -2711,7 +3143,7 @@ async function resolveToken(options, existingToken) {
     });
     if (isCancel(authChoice)) {
       cancel("MCP setup cancelled.");
-      process7.exit(0);
+      process8.exit(0);
     }
     if (authChoice === "existing") {
       return existingToken;
@@ -2734,7 +3166,7 @@ async function resolveToken(options, existingToken) {
   });
   if (isCancel(token)) {
     cancel("MCP setup cancelled.");
-    process7.exit(0);
+    process8.exit(0);
   }
   return token;
 }
@@ -2765,7 +3197,7 @@ async function addFlow(options) {
   const mcpAgents = getMcpAgents();
   if (mcpAgents.length === 0) {
     log.error("No agents with MCP configuration support found.");
-    process7.exit(1);
+    process8.exit(1);
   }
   const selectedAgent = await selectTool(mcpAgents, options.tool);
   const scope = await selectScope(selectedAgent, options);
@@ -2774,7 +3206,7 @@ async function addFlow(options) {
   });
   if (!configPath) {
     log.error(`No ${scope} config path available for ${selectedAgent.name}.`);
-    process7.exit(1);
+    process8.exit(1);
   }
   const token = await resolveToken(options, config.token);
   const env = buildEnvVars(token, options.server);
@@ -2799,7 +3231,7 @@ async function addFlow(options) {
     mcpSpinner.stop("Configuration failed");
     const message = error instanceof Error ? error.message : String(error);
     log.error(`Failed to write config: ${message}`);
-    process7.exit(1);
+    process8.exit(1);
   }
 }
 async function removeFlow(options) {
@@ -2811,7 +3243,7 @@ async function removeFlow(options) {
   });
   if (!configPath) {
     log.error(`No ${scope} config path available for ${selectedAgent.name}.`);
-    process7.exit(1);
+    process8.exit(1);
   }
   const removeSpinner = spinner();
   removeSpinner.start(`Removing braid from ${selectedAgent.name}...`);
@@ -2837,7 +3269,7 @@ async function removeFlow(options) {
     removeSpinner.stop("Removal failed");
     const message = error instanceof Error ? error.message : String(error);
     log.error(`Failed to remove config: ${message}`);
-    process7.exit(1);
+    process8.exit(1);
   }
 }
 async function statusFlow() {
@@ -2874,7 +3306,27 @@ async function statusFlow() {
     log.info(`  ${result.name} (${result.scope}) \u2192 ${result.path}`);
   }
 }
+function helpCommandsFlow() {
+  log.info("MCP manual command reference:");
+  log.info("  braid projects list --json");
+  log.info("  braid rules list --json");
+  log.info("  braid skills list --profile <name> --json");
+  log.info("");
+  log.info("Common local management commands:");
+  log.info("  braid install --yes --profile <name>");
+  log.info("  braid update --yes");
+  log.info("  braid list");
+  log.info("  braid remove --yes --all");
+  log.info(
+    "  braid scope --file user --organization personal --source profile --profile <name>"
+  );
+}
 async function mcpCommand(options) {
+  if (options.helpCommands) {
+    intro("braid mcp help");
+    helpCommandsFlow();
+    return;
+  }
   if (options.status) {
     intro("braid mcp status");
     await statusFlow();
@@ -2889,11 +3341,306 @@ async function mcpCommand(options) {
   await addFlow(options);
 }
 
+// src/commands/profiles.ts
+init_esm_shims();
+init_api();
+init_tui();
+import process9 from "process";
+var writeJson2 = (value) => {
+  process9.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+};
+var exitWithError2 = (error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  log.error(message);
+  process9.exit(1);
+};
+var fail = (message) => {
+  throw new Error(message);
+};
+var parseContext = (contextJson) => {
+  if (!contextJson) {
+    return void 0;
+  }
+  return JSON.parse(contextJson);
+};
+var run = async (command, args, options) => {
+  const apiOptions = {
+    ...options.server ? { serverUrl: options.server } : {},
+    ...options.apiKey ? { apiKey: options.apiKey } : {}
+  };
+  const result = await runLifecycleCommandAsync(
+    {
+      domain: "profiles",
+      command,
+      args
+    },
+    apiOptions
+  );
+  if (options.json) {
+    writeJson2(result);
+    return;
+  }
+  log.success(`profiles ${command} completed`);
+};
+async function profilesListCommand(options) {
+  try {
+    await run("list", {}, options);
+  } catch (error) {
+    exitWithError2(error);
+  }
+}
+async function profilesGetCommand(options) {
+  try {
+    if (!(options.id || options.name)) {
+      fail("profiles get requires --id or --name");
+    }
+    await run("get", { id: options.id, name: options.name }, options);
+  } catch (error) {
+    exitWithError2(error);
+  }
+}
+async function profilesCreateCommand(options) {
+  try {
+    const name = options.name ?? fail("profiles create requires --name");
+    await run(
+      "create",
+      { name, context: parseContext(options.contextJson) },
+      options
+    );
+  } catch (error) {
+    exitWithError2(error);
+  }
+}
+async function profilesUpdateCommand(options) {
+  try {
+    const id = options.id ?? fail("profiles update requires --id");
+    await run(
+      "update",
+      {
+        id,
+        name: options.name,
+        context: parseContext(options.contextJson)
+      },
+      options
+    );
+  } catch (error) {
+    exitWithError2(error);
+  }
+}
+async function profilesRemoveCommand(options) {
+  try {
+    const id = options.id ?? fail("profiles remove requires --id");
+    if (!options.yes) {
+      fail("profiles remove requires --yes");
+    }
+    await run("remove", { id, yes: true }, options);
+  } catch (error) {
+    exitWithError2(error);
+  }
+}
+async function profilesSetDefaultCommand(options) {
+  try {
+    const id = options.id ?? fail("profiles set-default requires --id");
+    await run("set-default", { id }, options);
+  } catch (error) {
+    exitWithError2(error);
+  }
+}
+
+// src/commands/projects.ts
+init_esm_shims();
+init_api();
+init_tui();
+import process10 from "process";
+var writeJson3 = (value) => {
+  process10.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+};
+var fail2 = (message) => {
+  throw new Error(message);
+};
+var run2 = async (command, args, options) => {
+  const apiOptions = {
+    ...options.server ? { serverUrl: options.server } : {},
+    ...options.apiKey ? { apiKey: options.apiKey } : {}
+  };
+  const result = await runLifecycleCommandAsync(
+    {
+      domain: "projects",
+      command,
+      args
+    },
+    apiOptions
+  );
+  if (options.json) {
+    writeJson3(result);
+    return;
+  }
+  log.success(`projects ${command} completed`);
+};
+var exitWithError3 = (error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  log.error(message);
+  process10.exit(1);
+};
+async function projectsGetCommand(options) {
+  try {
+    const id = options.id ?? fail2("projects get requires --id");
+    await run2("get", { id }, options);
+  } catch (error) {
+    exitWithError3(error);
+  }
+}
+async function projectsCreateCommand(options) {
+  try {
+    const name = options.name ?? fail2("projects create requires --name");
+    await run2(
+      "create",
+      { name, description: options.description, orgId: options.orgId },
+      options
+    );
+  } catch (error) {
+    exitWithError3(error);
+  }
+}
+async function projectsUpdateCommand(options) {
+  try {
+    const id = options.id ?? fail2("projects update requires --id");
+    await run2(
+      "update",
+      {
+        id,
+        name: options.name,
+        description: options.description
+      },
+      options
+    );
+  } catch (error) {
+    exitWithError3(error);
+  }
+}
+async function projectsRemoveCommand(options) {
+  try {
+    const id = options.id ?? fail2("projects remove requires --id");
+    if (!options.yes) {
+      fail2("projects remove requires --yes");
+    }
+    await run2("remove", { id, yes: true }, options);
+  } catch (error) {
+    exitWithError3(error);
+  }
+}
+
+// src/commands/references.ts
+init_esm_shims();
+init_api();
+init_tui();
+import process11 from "process";
+var writeJson4 = (value) => {
+  process11.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+};
+var parseCsv2 = (input) => {
+  if (!input) {
+    return void 0;
+  }
+  const values = input.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
+  return values.length > 0 ? values : void 0;
+};
+var exitWithError4 = (error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  log.error(message);
+  process11.exit(1);
+};
+var fail3 = (message) => {
+  throw new Error(message);
+};
+var run3 = async (command, args, options) => {
+  const apiOptions = {
+    ...options.server ? { serverUrl: options.server } : {},
+    ...options.apiKey ? { apiKey: options.apiKey } : {}
+  };
+  const result = await runLifecycleCommandAsync(
+    {
+      domain: "references",
+      command,
+      args
+    },
+    apiOptions
+  );
+  if (options.json) {
+    writeJson4(result);
+    return;
+  }
+  log.success(`references ${command} completed`);
+};
+async function referencesListCommand(options) {
+  try {
+    const ruleId = options.ruleId ?? fail3("references list requires --rule-id");
+    await run3("list", { ruleId }, options);
+  } catch (error) {
+    exitWithError4(error);
+  }
+}
+async function referencesGetCommand(options) {
+  try {
+    const id = options.id ?? fail3("references get requires --id");
+    await run3("get", { id }, options);
+  } catch (error) {
+    exitWithError4(error);
+  }
+}
+async function referencesCreateCommand(options) {
+  try {
+    const ruleId = options.ruleId ?? fail3("references create requires --rule-id");
+    const file = options.file ?? fail3("references create requires --file");
+    await run3("create", { ruleId, file }, options);
+  } catch (error) {
+    exitWithError4(error);
+  }
+}
+async function referencesUpdateCommand(options) {
+  try {
+    const id = options.id ?? fail3("references update requires --id");
+    await run3(
+      "update",
+      { id, label: options.label, replaceFile: options.replaceFile },
+      options
+    );
+  } catch (error) {
+    exitWithError4(error);
+  }
+}
+async function referencesRemoveCommand(options) {
+  try {
+    const id = options.id ?? fail3("references remove requires --id");
+    if (!options.yes) {
+      fail3("references remove requires --yes");
+    }
+    await run3("remove", { id, yes: true }, options);
+  } catch (error) {
+    exitWithError4(error);
+  }
+}
+async function referencesReorderCommand(options) {
+  try {
+    const ruleId = options.ruleId ?? fail3("references reorder requires --rule-id");
+    const orderedIds = parseCsv2(options.orderedIds);
+    if (!orderedIds || orderedIds.length === 0) {
+      fail3("references reorder requires --ordered-ids");
+    }
+    await run3("reorder", { ruleId, orderedIds }, options);
+  } catch (error) {
+    exitWithError4(error);
+  }
+}
+
 // src/commands/remove.ts
 init_esm_shims();
 import { rm } from "fs/promises";
 import { join as join4, resolve as resolve3 } from "path";
-import process8 from "process";
+import process12 from "process";
 init_tui();
 async function collectInstalledSkills(detectedAgents, options) {
   const skillsToRemove = [];
@@ -2926,7 +3673,7 @@ async function selectSkillsToRemove(skillsToRemove, options) {
     if (selected.length === 0) {
       log.error(`Skill '${options.skill}' not found.`);
       log.info("Run 'braid list' to see installed skills.");
-      process8.exit(1);
+      process12.exit(1);
     }
     return selected;
   }
@@ -2945,7 +3692,7 @@ async function selectSkillsToRemove(skillsToRemove, options) {
   });
   if (isCancel(result)) {
     cancel("Remove cancelled.");
-    process8.exit(0);
+    process12.exit(0);
   }
   return result;
 }
@@ -2959,7 +3706,7 @@ async function confirmRemoval(selectedCount, options) {
   });
   if (isCancel(confirmed) || !confirmed) {
     cancel("Remove cancelled.");
-    process8.exit(0);
+    process12.exit(0);
   }
 }
 async function removeSkill(skill, removeSpinner) {
@@ -3023,7 +3770,203 @@ async function removeCommand(options) {
     removeSpinner.stop("Remove failed");
     const message = error instanceof Error ? error.message : String(error);
     log.error(message);
-    process8.exit(1);
+    process12.exit(1);
+  }
+}
+
+// src/commands/rules.ts
+init_esm_shims();
+init_api();
+init_tui();
+import process13 from "process";
+var parseCsv3 = (input) => {
+  if (!input) {
+    return void 0;
+  }
+  const values = input.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
+  return values.length > 0 ? values : void 0;
+};
+var writeJson5 = (value) => {
+  process13.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+};
+var exitWithError5 = (error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  log.error(message);
+  process13.exit(1);
+};
+var fail4 = (message) => {
+  throw new Error(message);
+};
+var run4 = async (command, args, options) => {
+  const apiOptions = {
+    ...options.server ? { serverUrl: options.server } : {},
+    ...options.apiKey ? { apiKey: options.apiKey } : {}
+  };
+  const result = await runLifecycleCommandAsync(
+    {
+      domain: "rules",
+      command,
+      args
+    },
+    apiOptions
+  );
+  if (options.json) {
+    writeJson5(result);
+    return;
+  }
+  log.success(`rules ${command} completed`);
+};
+async function rulesGetCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules get requires --id");
+    await run4("get", { id }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesCreateCommand(options) {
+  try {
+    const title = options.title ?? fail4("rules create requires --title");
+    const content = options.content ?? fail4("rules create requires --content");
+    await run4(
+      "create",
+      {
+        title,
+        content,
+        projectId: options.projectId,
+        tags: parseCsv3(options.tags),
+        priority: options.priority
+      },
+      options
+    );
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesUpdateCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules update requires --id");
+    await run4(
+      "update",
+      {
+        id,
+        title: options.title,
+        content: options.content,
+        tags: parseCsv3(options.tags),
+        priority: options.priority
+      },
+      options
+    );
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesRemoveCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules remove requires --id");
+    if (!options.yes) {
+      fail4("rules remove requires --yes");
+    }
+    await run4("remove", { id, yes: true }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesEnableCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules enable requires --id");
+    await run4("enable", { id }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesDisableCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules disable requires --id");
+    await run4("disable", { id }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesMoveCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules move requires --id");
+    const projectId = options.projectId ?? fail4("rules move requires --project-id");
+    await run4("move", { id, projectId }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesDuplicateCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules duplicate requires --id");
+    await run4(
+      "duplicate",
+      { id, targetProjectId: options.targetProjectId },
+      options
+    );
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesForkCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules fork requires --id");
+    await run4(
+      "fork",
+      { id, targetProjectId: options.targetProjectId },
+      options
+    );
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesSyncStatusCommand(options) {
+  try {
+    await run4("sync-status", { id: options.id }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesSyncHistoryCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules sync-history requires --id");
+    await run4("sync-history", { id }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesSyncEnableCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules sync-enable requires --id");
+    await run4("sync-enable", { id }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesSyncDisableCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules sync-disable requires --id");
+    await run4("sync-disable", { id }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesSyncCheckCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules sync-check requires --id");
+    await run4("sync-check", { id }, options);
+  } catch (error) {
+    exitWithError5(error);
+  }
+}
+async function rulesSyncNowCommand(options) {
+  try {
+    const id = options.id ?? fail4("rules sync-now requires --id");
+    await run4("sync-now", { id }, options);
+  } catch (error) {
+    exitWithError5(error);
   }
 }
 
@@ -3329,10 +4272,12 @@ program.name("braid").description(
   "Install braid prompts as agent skills to your local development environment"
 ).version(PACKAGE_VERSION);
 var auth = program.command("auth").description("Configure API key for braid authentication");
-auth.command("login", { isDefault: true }).description("Configure API key").option("-s, --server <url>", "braid server URL (for review apps, local dev)").action(authCommand);
+auth.command("login", { isDefault: true }).description("Configure API key").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--token <token>", "API key for non-interactive login").option("--no-scope", "Skip scope setup after login").action(authCommand);
 auth.command("status").description("Show current authentication status").action(authStatusCommand);
 auth.command("logout").description("Remove stored API key").action(authLogoutCommand);
-program.command("install").alias("add").description("Install skills from a profile or project").option("-p, --profile <name>", "Profile name to install from").option(
+program.command("install").alias("add").description(
+  "Install skills from a profile, project, or public source (@handle/slug)"
+).argument("[source]", "Public source to install from (e.g., @handle/slug)").option("-p, --profile <name>", "Profile name to install from").option(
   "--org-projects <ids>",
   "Comma-separated organization project IDs to install from"
 ).option(
@@ -3347,7 +4292,12 @@ program.command("install").alias("add").description("Install skills from a profi
 ).option("--no-include-org-globals", "Exclude organization's global prompts").option(
   "-a, --agents <list>",
   "Comma-separated list of agents (e.g., claude-code,opencode)"
-).option("-g, --global", "Install to global agent directories").option("-y, --yes", "Skip confirmation prompts").option("-l, --list", "Preview skills without installing").option("-s, --server <url>", "braid server URL (for review apps, local dev)").action(installCommand);
+).option("-g, --global", "Install to global agent directories").option("-y, --yes", "Skip confirmation prompts").option("-l, --list", "Preview skills without installing").option("-s, --server <url>", "braid server URL (for review apps, local dev)").action((source, options) => {
+  if (source) {
+    return installCommand(source, options);
+  }
+  return installCommand(options);
+});
 program.command("scope").description("Interactively configure braid.json or braid.user.json scope").option("--file <target>", "Config file target: user or project").option(
   "--organization <type>",
   "Scope organization for non-interactive mode: personal or organization"
@@ -3371,8 +4321,47 @@ program.command("scope").description("Interactively configure braid.json or brai
   "Include org global rules in non-interactive mode"
 ).option("-s, --server <url>", "braid server URL (for review apps, local dev)").action(scopeCommand);
 program.command("list").alias("ls").description("List installed skills").option("-g, --global", "List skills in global directories only").action(listCommand);
+var projects = program.command("projects").description("Discover available projects from braid");
+projects.command("list").description("List available personal and org projects").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(projectsListCommand);
+projects.command("get").description("Get a project by id").requiredOption("--id <id>", "Project ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(projectsGetCommand);
+projects.command("create").description("Create a project").requiredOption("--name <name>", "Project name").option("--description <description>", "Project description").option("--org-id <id>", "Organization ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(projectsCreateCommand);
+projects.command("update").description("Update a project").requiredOption("--id <id>", "Project ID").option("--name <name>", "Project name").option("--description <description>", "Project description").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(projectsUpdateCommand);
+projects.command("remove").description("Remove a project").requiredOption("--id <id>", "Project ID").option("-y, --yes", "Confirm destructive action").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(projectsRemoveCommand);
+var rules = program.command("rules").description("Discover available rules from braid");
+rules.command("list").description("List available rules for a scope").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--org-id <id>", "Organization ID").option("--org-projects <ids>", "Comma-separated organization project IDs").option("--personal-projects <ids>", "Comma-separated personal project IDs").option("--include-user-global", "Include personal global rules").option("--include-org-global", "Include org global rules").option("--json", "Output JSON").action(rulesListCommand);
+rules.command("get").description("Get a rule by id").requiredOption("--id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesGetCommand);
+rules.command("create").description("Create a rule").requiredOption("--title <title>", "Rule title").requiredOption("--content <content>", "Rule content").option("--project-id <id>", "Project ID").option("--tags <list>", "Comma-separated tags").option("--priority <priority>", "Priority").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesCreateCommand);
+rules.command("update").description("Update a rule").requiredOption("--id <id>", "Rule ID").option("--title <title>", "Rule title").option("--content <content>", "Rule content").option("--tags <list>", "Comma-separated tags").option("--priority <priority>", "Priority").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesUpdateCommand);
+rules.command("remove").description("Remove a rule").requiredOption("--id <id>", "Rule ID").option("-y, --yes", "Confirm destructive action").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesRemoveCommand);
+rules.command("enable").description("Enable a rule").requiredOption("--id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesEnableCommand);
+rules.command("disable").description("Disable a rule").requiredOption("--id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesDisableCommand);
+rules.command("move").description("Move a rule to a project").requiredOption("--id <id>", "Rule ID").requiredOption("--project-id <id>", "Project ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesMoveCommand);
+rules.command("duplicate").description("Duplicate a rule").requiredOption("--id <id>", "Rule ID").option("--target-project-id <id>", "Target project ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesDuplicateCommand);
+rules.command("fork").description("Fork a rule").requiredOption("--id <id>", "Rule ID").option("--target-project-id <id>", "Target project ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesForkCommand);
+rules.command("sync-status").description("Show sync status for one rule or all").option("--id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesSyncStatusCommand);
+rules.command("sync-history").description("Show sync history for a rule").requiredOption("--id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesSyncHistoryCommand);
+rules.command("sync-enable").description("Enable sync for a rule").requiredOption("--id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesSyncEnableCommand);
+rules.command("sync-disable").description("Disable sync for a rule").requiredOption("--id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesSyncDisableCommand);
+rules.command("sync-check").description("Check for upstream updates").requiredOption("--id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesSyncCheckCommand);
+rules.command("sync-now").description("Run sync now").requiredOption("--id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(rulesSyncNowCommand);
+var skills = program.command("skills").description("Discover available skills from braid");
+skills.command("list").description("List available skills for a profile or project scope").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("-p, --profile <name>", "Profile name").option("--org-projects <ids>", "Comma-separated organization project IDs").option("--personal-projects <ids>", "Comma-separated personal project IDs").option("--include-user-global", "Include personal global rules").option("--include-org-global", "Include org global rules").option("--json", "Output JSON").action(skillsListCommand);
+var profiles = program.command("profiles").description("Manage scope profiles");
+profiles.command("list").description("List profiles").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(profilesListCommand);
+profiles.command("get").description("Get profile by id or name").option("--id <id>", "Profile ID").option("--name <name>", "Profile name").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(profilesGetCommand);
+profiles.command("create").description("Create profile").requiredOption("--name <name>", "Profile name").option("--context-json <json>", "Context JSON").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(profilesCreateCommand);
+profiles.command("update").description("Update profile").requiredOption("--id <id>", "Profile ID").option("--name <name>", "Profile name").option("--context-json <json>", "Context JSON").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(profilesUpdateCommand);
+profiles.command("remove").description("Remove profile").requiredOption("--id <id>", "Profile ID").option("-y, --yes", "Confirm destructive action").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(profilesRemoveCommand);
+profiles.command("set-default").description("Set default profile").requiredOption("--id <id>", "Profile ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(profilesSetDefaultCommand);
+var references = program.command("references").description("Manage rule references");
+references.command("list").description("List references for a rule").requiredOption("--rule-id <id>", "Rule ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(referencesListCommand);
+references.command("get").description("Get a reference by id").requiredOption("--id <id>", "Reference ID").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(referencesGetCommand);
+references.command("create").description("Create a reference from file").requiredOption("--rule-id <id>", "Rule ID").requiredOption("--file <path>", "Reference file path").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(referencesCreateCommand);
+references.command("update").description("Update reference metadata").requiredOption("--id <id>", "Reference ID").option("--label <label>", "Reference label").option("--replace-file <path>", "Replace reference with file").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(referencesUpdateCommand);
+references.command("remove").description("Remove reference").requiredOption("--id <id>", "Reference ID").option("-y, --yes", "Confirm destructive action").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(referencesRemoveCommand);
+references.command("reorder").description("Reorder references").requiredOption("--rule-id <id>", "Rule ID").requiredOption("--ordered-ids <ids>", "Comma-separated reference IDs").option("-s, --server <url>", "braid server URL (for review apps, local dev)").option("--api-key <token>", "API key override").option("--json", "Output JSON").action(referencesReorderCommand);
 program.command("update").alias("up").description("Update installed skills to the latest version").option("-g, --global", "Update skills in global directories only").option("-y, --yes", "Skip confirmation prompts").option("-s, --server <url>", "braid server URL (for review apps, local dev)").action(updateCommand);
 program.command("remove").alias("rm").description("Remove installed skills").option("-a, --all", "Remove all installed skills").option("-g, --global", "Remove skills from global directories only").option("-y, --yes", "Skip confirmation prompts").option("--skill <name>", "Remove a specific skill by name").action(removeCommand);
-program.command("mcp").description("Configure braid MCP in your AI coding tools").option("-t, --tool <name>", "Tool to configure").option("-g, --global", "Use global config instead of project").option("--token <token>", "API token to embed").option("--no-auth", "Skip authentication setup").option("--scope", "Run interactive scope configuration").option("--remove", "Remove braid MCP from a tool").option("--status", "Show which tools have braid MCP configured").option("-y, --yes", "Skip confirmation prompts").option("-s, --server <url>", "Custom MCP server URL").action(mcpCommand);
+program.command("mcp").description("Configure braid MCP in your AI coding tools").option("-t, --tool <name>", "Tool to configure").option("-g, --global", "Use global config instead of project").option("--token <token>", "API token to embed").option("--no-auth", "Skip authentication setup").option("--scope", "Run interactive scope configuration").option("--remove", "Remove braid MCP from a tool").option("--status", "Show which tools have braid MCP configured").option("--help-commands", "Show MCP manual command reference").option("-y, --yes", "Skip confirmation prompts").option("-s, --server <url>", "Custom MCP server URL").action(mcpCommand);
 program.parse();
 //# sourceMappingURL=index.js.map