skillex 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.4] - 2026-04-08
+
+### Changed
+- `skillex ui` skill list now shows compact labels: `Name (id) · tag1, tag2, tag3` — description and full compatibility list removed from each row
+- `skillex ui` shows "Fetching catalog..." while loading and limits visible rows to 12 at a time
+- `skillex install` and `skillex update` now render an inline progress bar (`[████░░░░] 1/5 skill-id`) instead of printing one line per skill
+
 ## [0.2.3] - 2026-04-08
 
 ### Fixed

package/dist/cli.js

@@ -362,11 +362,9 @@ async function handleInstall(positionals, flags, userConfig) {
     const result = await installSkills(positionals, {
         ...opts,
         installAll,
-        onProgress: (current, total, skillId) => {
-            output.info(`[${current}/${total}] Installing ${skillId}...`);
-        },
+        onProgress: (current, total, skillId) => output.progress(current, total, skillId),
     });
-    output.success(`Installed ${result.installedCount} skill(s) to ${result.statePaths.scope} state at ${result.statePaths.stateDir}`);
+    output.success(`Installed ${result.installedCount} skill(s)`);
     for (const skill of result.installedSkills) {
         output.info(`  + ${skill.id}@${skill.version}`);
     }
@@ -374,7 +372,10 @@ async function handleInstall(positionals, flags, userConfig) {
 }
 async function handleUpdate(positionals, flags, userConfig) {
     const opts = commonOptions(flags, userConfig);
-    const result = await updateInstalledSkills(positionals, opts);
+    const result = await updateInstalledSkills(positionals, {
+        ...opts,
+        onProgress: (current, total, skillId) => output.progress(current, total, skillId),
+    });
     if (result.updatedSkills.length === 0) {
         output.info("No skills updated.");
     }
@@ -437,7 +438,9 @@ async function handleUi(flags, userConfig) {
     const options = commonOptions(flags, userConfig);
     const state = await getInstalledSkills(options);
     const source = await resolveProjectSource(options);
+    output.statusLine("Fetching catalog...");
     const catalog = await loadCatalog({ ...source, ...cacheOptions(options) });
+    output.clearStatus();
     if (catalog.skills.length === 0) {
         output.info("No skills available in the catalog.");
         return;
@@ -450,19 +453,24 @@ async function handleUi(flags, userConfig) {
             : "No skills available in the catalog.");
         return;
     }
-    const installResult = selection.toInstall.length > 0 ? await installSkills(selection.toInstall, options) : null;
+    const installResult = selection.toInstall.length > 0
+        ? await installSkills(selection.toInstall, {
+            ...options,
+            onProgress: (current, total, skillId) => output.progress(current, total, skillId),
+        })
+        : null;
     const removeResult = selection.toRemove.length > 0 ? await removeSkills(selection.toRemove, options) : null;
     if (!installResult && !removeResult) {
         output.info("No changes applied.");
         return;
     }
-    output.success("UI summary:");
     if (installResult) {
-        output.info(`  Installed : ${installResult.installedSkills.map((s) => s.id).join(", ")}`);
+        output.success(`Installed: ${installResult.installedSkills.map((s) => s.id).join(", ")}`);
     }
     if (removeResult) {
-        output.info(`  Removed   : ${removeResult.removedSkills.join(", ")}`);
+        output.success(`Removed: ${removeResult.removedSkills.join(", ")}`);
     }
+    printAutoSyncResult(installResult?.autoSync ?? removeResult?.autoSync ?? null);
 }
 async function handleStatus(flags, userConfig) {
     const options = commonOptions(flags, userConfig);

package/dist/output.d.ts

@@ -44,3 +44,22 @@ export declare function error(message: string): void;
  * @param message - Debug message.
  */
 export declare function debug(message: string): void;
+/**
+ * Renders an inline progress bar that overwrites the current line.
+ * Prints a newline when current === total.
+ *
+ * @param current - Number of completed items (1-based).
+ * @param total - Total number of items.
+ * @param label - Short label shown after the bar.
+ */
+export declare function progress(current: number, total: number, label: string): void;
+/**
+ * Writes a transient status message on the current line (overwritable with clearStatus).
+ *
+ * @param message - Status message to display.
+ */
+export declare function statusLine(message: string): void;
+/**
+ * Clears the current status line written by {@link statusLine}.
+ */
+export declare function clearStatus(): void;

package/dist/output.js

@@ -76,3 +76,46 @@ export function debug(message) {
         process.stderr.write(applyColor("2", `[debug] ${message}`, process.stderr) + "\n");
     }
 }
+// ---------------------------------------------------------------------------
+// Progress and status helpers (TTY-only; fall back to plain lines otherwise)
+// ---------------------------------------------------------------------------
+/**
+ * Renders an inline progress bar that overwrites the current line.
+ * Prints a newline when current === total.
+ *
+ * @param current - Number of completed items (1-based).
+ * @param total - Total number of items.
+ * @param label - Short label shown after the bar.
+ */
+export function progress(current, total, label) {
+    if (!process.stdout.isTTY) {
+        console.log(`[${current}/${total}] ${label}`);
+        return;
+    }
+    const filled = total > 0 ? Math.round((current / total) * 16) : 0;
+    const bar = applyColor("32", "█".repeat(filled), process.stdout) + "░".repeat(16 - filled);
+    const counter = applyColor("2", `${current}/${total}`, process.stdout);
+    const line = `  [${bar}] ${counter}  ${label}`;
+    process.stdout.write(`\r${line}\x1b[K`);
+    if (current === total) {
+        process.stdout.write("\n");
+    }
+}
+/**
+ * Writes a transient status message on the current line (overwritable with clearStatus).
+ *
+ * @param message - Status message to display.
+ */
+export function statusLine(message) {
+    if (!process.stdout.isTTY)
+        return;
+    process.stdout.write(`\r  ${applyColor("2", message, process.stdout)}\x1b[K`);
+}
+/**
+ * Clears the current status line written by {@link statusLine}.
+ */
+export function clearStatus() {
+    if (!process.stdout.isTTY)
+        return;
+    process.stdout.write("\r\x1b[K");
+}

package/dist/ui.d.ts

@@ -12,6 +12,7 @@ interface UiPrompts {
     checkbox?: ((options: {
         message: string;
         instructions?: string | undefined;
+        pageSize?: number | undefined;
         choices: UiChoice[];
     }) => Promise<string[]>) | undefined;
 }

package/dist/ui.js

@@ -33,13 +33,21 @@ export async function runInteractiveUi(options) {
     const selectedIds = filteredSkills.length === 0
         ? []
         : await (prompts.checkbox || fallbackCheckbox)({
-            message: "Selecione as skills",
-            instructions: "Type to filter first • Space to select • Enter to install",
-            choices: filteredSkills.map((skill) => ({
-                name: `${skill.name} (${skill.id}) - ${skill.description || "Sem descricao"} [${skill.compatibility.join(",") || "sem-compat"}]`,
-                value: skill.id,
-                checked: installedSet.has(skill.id),
-            })),
+            message: "Select skills",
+            instructions: "↑↓ navigate  ·  space select  ·  enter confirm  ·  type to filter",
+            pageSize: 12,
+            choices: filteredSkills.map((skill) => {
+                const tags = (skill.tags ?? []).slice(0, 4).join(", ");
+                const detail = tags || (skill.description ?? "").slice(0, 55);
+                const label = detail
+                    ? `${skill.name}  (${skill.id})  ·  ${detail}`
+                    : `${skill.name}  (${skill.id})`;
+                return {
+                    name: label,
+                    value: skill.id,
+                    checked: installedSet.has(skill.id),
+                };
+            }),
         });
     const selectedSet = new Set(selectedIds);
     const toInstall = selectedIds.filter((skillId) => !installedSet.has(skillId));
@@ -62,6 +70,7 @@ async function loadPromptAdapters() {
         checkbox: async (options) => prompts.checkbox({
             message: options.message,
             ...(options.instructions ? { instructions: options.instructions } : {}),
+            ...(options.pageSize !== undefined ? { pageSize: options.pageSize } : {}),
             choices: options.choices.map((choice) => ({
                 name: choice.name,
                 value: choice.value,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillex",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "CLI to list, install, and synchronize AI agent skills from GitHub-hosted catalogs.",
   "type": "module",
   "repository": {