@guanmu/ccprofile 0.1.16 → 0.1.18

package/README.md

@@ -1,5 +1,13 @@
 # ccx
 
+```text
+   ______ ______ __   __
+  / ____// ____/ \ \ / /
+ | |    | |      \ V /
+ | |___ | |___   / . \
+  \____/ \____/ /_/ \_\
+```
+
 Agent Profile Manager for Claude Code.
 
 `ccx` lets you save named Claude Code plugin profiles and install a whole profile into the current project with one command. It is designed as a command-first CLI, with a lightweight interactive wizard for manual use.

package/dist/index.js

@@ -7,6 +7,17 @@ import * as p from "@clack/prompts";
 import pc from "picocolors";
 const PROFILES_DIR = path.join(process.env.HOME, ".ccx", "profiles");
 const MARKETPLACES_DIR = path.join(process.env.HOME, ".claude", "plugins", "marketplaces");
+const PROJECT_CONFIG_FILE = ".ccx.json";
+const LOGO_LINES = [
+    "   ______ ______ __   __",
+    "  / ____// ____/ \\ \\ / /",
+    " | |    | |      \\ V /",
+    " | |___ | |___   / . \\",
+    "  \\____/ \\____/ /_/ \\_\\",
+];
+function renderLogo() {
+    return LOGO_LINES.map((line, index) => index < 2 ? pc.cyan(line) : pc.magenta(line)).join("\n");
+}
 function ensureProfilesDir() {
     fs.mkdirSync(PROFILES_DIR, { recursive: true });
 }
@@ -78,6 +89,36 @@ function writeProfile(name, data) {
     ensureProfilesDir();
     fs.writeFileSync(profilePath(normalized), JSON.stringify({ ...data, name: normalized }, null, 2) + "\n");
 }
+function readProjectConfig() {
+    const file = path.join(process.cwd(), PROJECT_CONFIG_FILE);
+    if (!fs.existsSync(file)) {
+        p.log.error(`No ${PROJECT_CONFIG_FILE} found. Run \`ccx init\` to create one.`);
+        process.exit(1);
+    }
+    let data;
+    try {
+        data = JSON.parse(fs.readFileSync(file, "utf-8"));
+    }
+    catch {
+        p.log.error(`Invalid ${PROJECT_CONFIG_FILE}. Expected valid JSON.`);
+        process.exit(1);
+    }
+    if (!data ||
+        typeof data !== "object" ||
+        !Array.isArray(data.plugins)) {
+        p.log.error(`Invalid ${PROJECT_CONFIG_FILE}. Expected a plugins array.`);
+        process.exit(1);
+    }
+    const plugins = data.plugins.map((plugin) => typeof plugin === "string" ? plugin.trim() : undefined);
+    if (plugins.some((plugin) => !plugin)) {
+        p.log.error(`Invalid ${PROJECT_CONFIG_FILE}. Plugin entries must be non-empty strings.`);
+        process.exit(1);
+    }
+    return plugins;
+}
+function writeProjectConfig(plugins) {
+    fs.writeFileSync(path.join(process.cwd(), PROJECT_CONFIG_FILE), JSON.stringify({ plugins }, null, 2) + "\n");
+}
 function getProfileNames() {
     ensureProfilesDir();
     return fs
@@ -411,20 +452,12 @@ async function browsePlugins(currentProfile) {
     }
     return [];
 }
-async function executeProfile(profileName) {
-    const normalizedProfileName = normalizeProfileName(profileName);
-    if (!normalizedProfileName)
-        return;
-    const data = readProfile(normalizedProfileName);
-    if (data.plugins.length === 0) {
-        p.log.warn(`No plugins to install in profile "${normalizedProfileName}".`);
-        return;
-    }
+async function installPlugins(plugins, label) {
     const s = p.spinner();
-    s.start(`Installing ${data.plugins.length} plugin(s) from "${normalizedProfileName}"...`);
+    s.start(`Installing ${plugins.length} plugin(s) from "${label}"...`);
     let installed = 0;
     let failed = 0;
-    for (const plugin of data.plugins) {
+    for (const plugin of plugins) {
         s.message(`Installing ${plugin}...`);
         try {
             execFileSync("claude", ["plugin", "install", plugin, "--scope", "project"], {
@@ -440,10 +473,144 @@ async function executeProfile(profileName) {
     s.stop(`${installed} installed${failed > 0 ? `, ${failed} failed` : ""}`);
     p.log.success("Done.");
 }
+async function executeProfile(profileName) {
+    const normalizedProfileName = normalizeProfileName(profileName);
+    if (!normalizedProfileName)
+        return;
+    const data = readProfile(normalizedProfileName);
+    if (data.plugins.length === 0) {
+        p.log.warn(`No plugins to install in profile "${normalizedProfileName}".`);
+        return;
+    }
+    await installPlugins(data.plugins, normalizedProfileName);
+}
+async function executeProjectConfig() {
+    const file = path.join(process.cwd(), PROJECT_CONFIG_FILE);
+    if (!fs.existsSync(file)) {
+        p.log.error(`No ${PROJECT_CONFIG_FILE} found. Run \`ccx init\` to create one.`);
+        process.exitCode = 1;
+        return;
+    }
+    const plugins = readProjectConfig();
+    if (plugins.length === 0) {
+        p.log.warn(`No plugins in ${PROJECT_CONFIG_FILE}.`);
+        return;
+    }
+    await installPlugins(plugins, PROJECT_CONFIG_FILE);
+}
+async function initProjectConfig() {
+    if (!canPrompt()) {
+        console.error("ccx init requires a TTY.");
+        process.exitCode = 1;
+        return;
+    }
+    const file = path.join(process.cwd(), PROJECT_CONFIG_FILE);
+    if (fs.existsSync(file)) {
+        const overwrite = await p.confirm({
+            message: `${PROJECT_CONFIG_FILE} already exists. Overwrite?`,
+            initialValue: false,
+        });
+        if (p.isCancel(overwrite) || !overwrite)
+            return;
+    }
+    const allPlugins = getAllPlugins();
+    let selected;
+    if (allPlugins.length === 0) {
+        const input = (await p.text({
+            message: "No marketplace plugins found. Enter plugin names (comma-separated):",
+            placeholder: "plugin-a, plugin-b",
+        }));
+        if (p.isCancel(input))
+            return;
+        selected = input.split(",").map((s) => s.trim()).filter(Boolean);
+    }
+    else {
+        let filtered = allPlugins;
+        if (allPlugins.length > 10) {
+            const query = (await p.text({
+                message: "Search plugins (leave empty to list all):",
+            }));
+            if (p.isCancel(query))
+                return;
+            const q = query.trim().toLowerCase();
+            if (q) {
+                filtered = allPlugins.filter((pl) => pl.name.toLowerCase().includes(q) ||
+                    pl.description.toLowerCase().includes(q) ||
+                    (pl.category && pl.category.toLowerCase().includes(q)));
+                if (filtered.length === 0) {
+                    p.log.warn(`No plugins matching "${query.trim()}".`);
+                    return;
+                }
+            }
+        }
+        const picked = await p.multiselect({
+            message: "Select plugins for this project:",
+            options: filtered.map((pl) => ({
+                value: pl.name,
+                label: pl.name,
+                hint: pl.description.slice(0, 50),
+            })),
+            required: false,
+        });
+        if (p.isCancel(picked))
+            return;
+        selected = picked;
+    }
+    writeProjectConfig(selected);
+    p.log.success(`Created ${PROJECT_CONFIG_FILE} with ${selected.length} plugin(s).`);
+}
+function syncProjectConfig() {
+    const pluginsDir = path.join(process.cwd(), ".claude", "plugins");
+    if (!fs.existsSync(pluginsDir)) {
+        p.log.warn("No project plugins found (.claude/plugins/).");
+        return;
+    }
+    const entries = fs.readdirSync(pluginsDir, { withFileTypes: true });
+    const plugins = entries
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name)
+        .filter((name) => !name.startsWith("."))
+        .sort();
+    if (plugins.length === 0) {
+        p.log.warn("No project plugins found (.claude/plugins/).");
+        return;
+    }
+    writeProjectConfig(plugins);
+    p.log.success(`Synced ${plugins.length} plugin(s) to ${PROJECT_CONFIG_FILE}.`);
+}
+async function saveToProfile(name) {
+    const plugins = readProjectConfig();
+    if (!name) {
+        if (!canPrompt()) {
+            missingArg("Profile name is required.", "ccx save <name>");
+            return;
+        }
+        name = (await p.text({
+            message: "Save as profile:",
+        }));
+        if (p.isCancel(name))
+            return;
+    }
+    name = normalizeProfileName(name);
+    if (!name)
+        return;
+    const file = profilePath(name);
+    if (fs.existsSync(file)) {
+        const overwrite = await p.confirm({
+            message: `Profile "${name}" already exists. Overwrite?`,
+            initialValue: false,
+        });
+        if (p.isCancel(overwrite) || !overwrite)
+            return;
+    }
+    writeProfile(name, { name, plugins });
+    p.log.success(`Saved ${plugins.length} plugin(s) to profile "${name}".`);
+}
 function printBanner() {
     const require = createRequire(import.meta.url);
     const pkg = require("../package.json");
-    p.note(pc.bold("ccx") + pc.dim(" — Agent Profile Manager  ") + pc.gray(`v${pkg.version}`));
+    console.log(`${renderLogo()}\n`);
+    p.note(pc.bold("ccx") + pc.dim(" - Agent Profile Manager  ") + pc.gray(`v${pkg.version}`));
 }
 async function interactiveMode() {
     if (!canPrompt()) {
@@ -517,11 +684,17 @@ async function interactiveMode() {
     p.outro("Done.");
 }
 function printHelp() {
-    console.log(`ccx — Agent Profile Manager for Claude Code
+    console.log(`${renderLogo()}
+
+ccx - Agent Profile Manager for Claude Code
 
 Usage:
   ccx                            Interactive mode (TTY only)
   ccx ui                         Interactive mode (TTY only)
+  ccx init                       Create .ccx.json for current project
+  ccx sync                       Sync installed plugins to .ccx.json
+  ccx save [name]                Save .ccx.json plugins as a profile
+  ccx install                    Install plugins from .ccx.json
   ccx install <profile>          Install all plugins from profile
   ccx create <name>              Create a new profile
   ccx delete <name>              Remove a profile
@@ -557,6 +730,15 @@ async function main(args) {
     }
     const cmd = args[0];
     switch (cmd) {
+        case "init":
+            await initProjectConfig();
+            break;
+        case "sync":
+            syncProjectConfig();
+            break;
+        case "save":
+            await saveToProfile(args[1]);
+            break;
         case "ui":
         case "tui":
         case "interactive":
@@ -564,7 +746,7 @@ async function main(args) {
             break;
         case "install":
             if (!args[1]) {
-                missingArg("Profile name is required.", "ccx install <profile>");
+                await executeProjectConfig();
                 return;
             }
             await executeProfile(args[1]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanmu/ccprofile",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Agent Profile Manager for Claude Code",
   "type": "module",
   "bin": {