@guanmu/ccprofile 0.1.9 → 0.1.11

package/README.md

@@ -0,0 +1,146 @@
+# ccx
+
+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.
+
+## Installation
+
+```bash
+npm install -g @guanmu/ccprofile
+```
+
+Or with Bun:
+
+```bash
+bun add -g @guanmu/ccprofile@latest
+```
+
+Verify the installed version:
+
+```bash
+ccx --version
+```
+
+## Quick Start
+
+```bash
+ccx create dev
+ccx add dev cc-design
+ccx add dev browser
+ccx list dev
+ccx install dev
+```
+
+`ccx install dev` runs `claude plugin install <plugin> --scope project` for every plugin in the `dev` profile.
+
+## Commands
+
+```bash
+ccx                            # Interactive wizard, TTY only
+ccx ui                         # Interactive wizard, TTY only
+
+ccx install <profile>          # Install all plugins from a profile
+ccx create <name>              # Create a profile
+ccx delete <name>              # Delete a profile
+ccx profiles                   # List all profiles
+
+ccx add <profile> <plugin>     # Add a plugin to a profile
+ccx remove <profile> <plugin>  # Remove a plugin from a profile
+ccx list <profile>             # List plugins in a profile
+ccx search <keyword>           # Search plugins in installed marketplaces
+
+ccx --version                  # Show version
+ccx --help                     # Show help
+```
+
+Legacy aliases are still supported:
+
+```bash
+ccx <profile>                  # Same as ccx install <profile>
+ccx <profile> add [plugin]
+ccx <profile> remove [plugin]
+ccx <profile> list
+ccx add <name>                 # Same as ccx create <name>
+ccx remove <name>              # Same as ccx delete <name>
+ccx list                       # Same as ccx profiles
+```
+
+## Interactive Wizard
+
+Run:
+
+```bash
+ccx
+```
+
+The wizard is grouped into lightweight pages:
+
+- `Install` - install plugins from a profile
+- `Profiles` - create, list, and delete profiles
+- `Plugins` - add, remove, and list profile plugins
+- `Marketplace` - search installed plugin marketplaces
+- `Help` - print command usage
+
+The wizard only runs in a real TTY. In scripts, CI, or agent execution environments, use the command form instead.
+
+## Profiles
+
+Profiles are stored as JSON files under:
+
+```text
+~/.ccx/profiles/
+```
+
+Example profile:
+
+```json
+{
+  "name": "dev",
+  "plugins": [
+    "cc-design",
+    "browser"
+  ]
+}
+```
+
+Profile names may contain letters, numbers, dots, underscores, and hyphens.
+
+## Marketplace Search
+
+`ccx search <keyword>` reads Claude plugin marketplaces from:
+
+```text
+~/.claude/plugins/marketplaces/
+```
+
+Search matches plugin name, description, or category. Invalid marketplace files are skipped with a warning.
+
+## Requirements
+
+- Node.js 20.12 or newer
+- Claude Code CLI available as `claude`
+- Claude plugin marketplaces installed if you want marketplace search
+
+## Development
+
+```bash
+pnpm install
+pnpm run build
+pnpm test
+```
+
+Run from source:
+
+```bash
+pnpm run dev
+```
+
+## Release
+
+This package is published to npm from GitHub Releases.
+
+1. Bump `package.json`.
+2. Commit and push to `master`.
+3. Create a GitHub release tag like `v0.1.10`.
+4. The `Publish to npm` workflow builds and publishes the package.

package/dist/index.js

@@ -140,6 +140,20 @@ function missingArg(message, usage) {
     console.error(`Usage: ${usage}`);
     process.exitCode = 1;
 }
+async function selectProfile(message) {
+    const names = getProfileNames();
+    if (names.length === 0) {
+        p.log.warn("No profiles found.");
+        return undefined;
+    }
+    const name = await p.select({
+        message,
+        options: names.map((n) => ({ value: n, label: n })),
+    });
+    if (p.isCancel(name))
+        return undefined;
+    return name;
+}
 // ── Commands ──────────────────────────────────────────────
 async function addProfile(name) {
     if (!name) {
@@ -376,6 +390,103 @@ async function executeProfile(profileName) {
     s.stop(`${installed} installed${failed > 0 ? `, ${failed} failed` : ""}`);
     p.log.success("Done.");
 }
+async function installWizard() {
+    while (true) {
+        const action = await p.select({
+            message: "Install",
+            options: [
+                { value: "install", label: "Install profile plugins", hint: "Run a profile" },
+                { value: "back", label: "Back" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(action) || action === "exit")
+            return "exit";
+        if (action === "back")
+            return "back";
+        const name = await selectProfile("Select profile to install:");
+        if (name)
+            await executeProfile(name);
+    }
+}
+async function profilesWizard() {
+    while (true) {
+        const action = await p.select({
+            message: "Profiles",
+            options: [
+                { value: "create", label: "Create profile", hint: "Create a new empty profile" },
+                { value: "list", label: "List profiles", hint: "Show all profiles" },
+                { value: "delete", label: "Delete profile", hint: "Remove a profile" },
+                { value: "back", label: "Back" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(action) || action === "exit")
+            return "exit";
+        if (action === "back")
+            return "back";
+        switch (action) {
+            case "create":
+                await addProfile();
+                break;
+            case "list":
+                await listProfiles();
+                break;
+            case "delete":
+                await removeProfile();
+                break;
+        }
+    }
+}
+async function pluginsWizard() {
+    while (true) {
+        const action = await p.select({
+            message: "Plugins",
+            options: [
+                { value: "add", label: "Add plugin to profile", hint: "Choose a profile, then a plugin" },
+                { value: "remove", label: "Remove plugin from profile", hint: "Choose a profile, then a plugin" },
+                { value: "list", label: "List profile plugins", hint: "Show plugins in a profile" },
+                { value: "back", label: "Back" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(action) || action === "exit")
+            return "exit";
+        if (action === "back")
+            return "back";
+        const name = await selectProfile("Select profile:");
+        if (!name)
+            continue;
+        switch (action) {
+            case "add":
+                await addPlugin(name);
+                break;
+            case "remove":
+                await removePlugin(name);
+                break;
+            case "list":
+                await listPlugins(name);
+                break;
+        }
+    }
+}
+async function marketplaceWizard() {
+    while (true) {
+        const action = await p.select({
+            message: "Marketplace",
+            options: [
+                { value: "search", label: "Search plugins", hint: "Search installed marketplaces" },
+                { value: "back", label: "Back" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(action) || action === "exit")
+            return "exit";
+        if (action === "back")
+            return "back";
+        await searchPlugins();
+    }
+}
 async function interactiveMode() {
     if (!canPrompt()) {
         printNonInteractiveHelp();
@@ -383,94 +494,40 @@ async function interactiveMode() {
         return;
     }
     p.intro("ccx — Agent Profile Manager");
-    const action = await p.select({
-        message: "What do you want to do?",
-        options: [
-            { value: "install", label: "Install profile plugins", hint: "Run a profile to install its plugins" },
-            { value: "plugin-add", label: "Add plugin to profile", hint: "Add a plugin to an existing profile" },
-            { value: "plugin-remove", label: "Remove plugin from profile", hint: "Remove a plugin from a profile" },
-            { value: "plugin-list", label: "List profile plugins", hint: "Show plugins in a profile" },
-            { value: "add", label: "Create new profile", hint: "Create a new empty profile" },
-            { value: "remove", label: "Delete profile", hint: "Remove a profile" },
-            { value: "list", label: "List all profiles", hint: "Show all profiles" },
-            { value: "search", label: "Search plugins", hint: "Search plugins in marketplaces" },
-        ],
-    });
-    if (p.isCancel(action))
-        return;
-    switch (action) {
-        case "install": {
-            const names = getProfileNames();
-            if (names.length === 0) {
-                p.log.warn("No profiles found.");
-                return;
-            }
-            const name = await p.select({
-                message: "Select profile to install:",
-                options: names.map((n) => ({ value: n, label: n })),
-            });
-            if (p.isCancel(name))
-                return;
-            await executeProfile(name);
-            break;
-        }
-        case "plugin-add": {
-            const names = getProfileNames();
-            if (names.length === 0) {
-                p.log.warn("No profiles found. Create one first.");
-                return;
-            }
-            const name = await p.select({
-                message: "Select profile:",
-                options: names.map((n) => ({ value: n, label: n })),
-            });
-            if (p.isCancel(name))
-                return;
-            await addPlugin(name);
-            break;
-        }
-        case "plugin-remove": {
-            const names = getProfileNames();
-            if (names.length === 0) {
-                p.log.warn("No profiles found.");
-                return;
-            }
-            const name = await p.select({
-                message: "Select profile:",
-                options: names.map((n) => ({ value: n, label: n })),
-            });
-            if (p.isCancel(name))
-                return;
-            await removePlugin(name);
-            break;
-        }
-        case "plugin-list": {
-            const names = getProfileNames();
-            if (names.length === 0) {
-                p.log.warn("No profiles found.");
-                return;
-            }
-            const name = await p.select({
-                message: "Select profile:",
-                options: names.map((n) => ({ value: n, label: n })),
-            });
-            if (p.isCancel(name))
-                return;
-            await listPlugins(name);
+    let shouldExit = false;
+    while (!shouldExit) {
+        const area = await p.select({
+            message: "Choose area:",
+            options: [
+                { value: "install", label: "Install", hint: "Run a profile" },
+                { value: "profiles", label: "Profiles", hint: "Create, list, or delete profiles" },
+                { value: "plugins", label: "Plugins", hint: "Manage plugins inside profiles" },
+                { value: "marketplace", label: "Marketplace", hint: "Search available plugins" },
+                { value: "help", label: "Help", hint: "Show command usage" },
+                { value: "exit", label: "Exit" },
+            ],
+        });
+        if (p.isCancel(area) || area === "exit")
             break;
+        let result = "back";
+        switch (area) {
+            case "install":
+                result = await installWizard();
+                break;
+            case "profiles":
+                result = await profilesWizard();
+                break;
+            case "plugins":
+                result = await pluginsWizard();
+                break;
+            case "marketplace":
+                result = await marketplaceWizard();
+                break;
+            case "help":
+                printHelp();
+                break;
         }
-        case "add":
-            await addProfile();
-            break;
-        case "remove":
-            await removeProfile();
-            break;
-        case "list":
-            await listProfiles();
-            break;
-        case "search":
-            await searchPlugins();
-            break;
+        shouldExit = result === "exit";
     }
     p.outro("Done.");
 }

package/package.json

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