claude-agent-skills 1.4.1 → 1.5.1

package/commands/hub.js

@@ -1,43 +1,75 @@
-import { select, isCancel, cancel, outro } from '@clack/prompts';
 import updateNotifier from 'update-notifier';
 import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
+import ansis from 'ansis';
 import { showIntro } from '../lib/banner.js';
 import { CliCancel } from '../lib/prompts.js';
+import { brand, muted, white } from '../lib/theme.js';
+import { inlineSelect } from '../lib/inlineSelect.js';
 
 const req = createRequire(import.meta.url);
 const pkg = req(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'));
 updateNotifier({ pkg }).notify();
-import { runAdd } from './add.js';
+
+import { runAdd }    from './add.js';
 import { runUpdate } from './update.js';
 import { runRemove } from './remove.js';
-import { runList } from './list.js';
-import { runSync } from './sync.js';
-import { runCheck } from './check.js';
+import { runList }   from './list.js';
+import { runSync }   from './sync.js';
+import { runCheck }  from './check.js';
 
 const SKIP = { skipIntro: true };
 
 const MENU = [
-  { value: 'add',    label: 'Add Skill(s)' },
-  { value: 'update', label: 'Update Existing Skill(s)' },
-  { value: 'remove', label: 'Remove Existing Skill(s)' },
-  { value: 'list',   label: 'List Installed Skill(s)' },
-  { value: 'sync',   label: 'Sync/Restore Skills from Lockfile' },
-  { value: 'check',  label: 'Check Skill(s)' },
+  { value: 'add',    label: 'Add Skill(s)',                hint: 'install new skills' },
+  { value: 'update', label: 'Update Existing Skill(s)',    hint: 'pull latest versions' },
+  { value: 'remove', label: 'Remove Existing Skill(s)',    hint: 'uninstall skills' },
+  { value: 'list',   label: 'List Installed Skill(s)',     hint: "show what's installed" },
+  { value: 'sync',   label: 'Sync/Restore from Lockfile',  hint: 'restore from claude-skills-lock.json' },
+  { value: 'check',  label: 'Check Skill(s)',              hint: 'verify hashes & lockfile' },
   { value: 'quit',   label: 'Quit' },
 ];
 
+function printCompactHeader() {
+  const silver = s => ansis.rgb(190, 190, 190)(s);
+  process.stdout.write('\n');
+  process.stdout.write(brand('◈ CLAUDE SKILLS') + '  ' + silver('Agent Skills for Claude Code') + '\n');
+  process.stdout.write('\n');
+}
+
+function restoreScreen() {
+  process.stdout.write('\x1b[?1049l');
+}
+
 export async function runHub() {
+  // Enter alternate screen buffer — isolated viewport with no scrollback accumulation.
+  // Original terminal content is restored when we exit (same as vim/less/claude-code).
+  process.stdout.write('\x1b[?1049h\x1b[2J\x1b[H');
+  process.on('exit', restoreScreen); // covers Ctrl+C, process.exit(), uncaught errors
+
   await showIntro();
 
+  let first = true;
   for (;;) {
-    const choice = await select({ message: 'What do you want to do?', options: MENU });
-
-    if (isCancel(choice)) { cancel('Cancelled.'); return; }
-    if (choice === 'quit') { outro('Goodbye.'); return; }
+    if (!first) {
+      process.stdout.write('\x1b[2J\x1b[H');
+      printCompactHeader();
+    }
+    first = false;
 
     try {
+      const choice = await inlineSelect({
+        message: 'What do you want to do?',
+        hint: '↑↓ navigate · enter select · esc quit',
+        options: MENU,
+      });
+
+      if (choice === 'quit') {
+        restoreScreen();
+        return;
+      }
+
       if (choice === 'add')    await runAdd(SKIP);
       if (choice === 'update') await runUpdate(SKIP);
       if (choice === 'remove') await runRemove(SKIP);
@@ -45,7 +77,12 @@ export async function runHub() {
       if (choice === 'sync')   await runSync(SKIP);
       if (choice === 'check')  await runCheck(SKIP);
     } catch (e) {
-      if (e instanceof CliCancel) continue;
+      if (e instanceof CliCancel) continue; // sub-command ESC → back to menu
+      if (e?.isCancel) {                    // hub menu ESC → quit
+        restoreScreen();
+        return;
+      }
+      restoreScreen();
       throw e;
     }
   }

package/lib/inlineSelect.js

@@ -0,0 +1,88 @@
+/**
+ * Single-select in-place picker — renders in-place like skillPicker.
+ * Resolves with selected value. Throws { isCancel: true } on ESC.
+ */
+import ansis from 'ansis';
+import { brand, white, muted } from './theme.js';
+
+const KEY = {
+  UP:     '\x1b[A',
+  DOWN:   '\x1b[B',
+  ENTER:  '\r',
+  CTRL_C: '\x03',
+  ESC:    '\x1b',
+};
+
+export async function inlineSelect({ message, hint = '↑↓ navigate · enter select · esc back', options }) {
+  let cursor = 0;
+  let lastLines = 0;
+
+  function renderLines() {
+    const out = [];
+    out.push(brand('◆') + '  ' + ansis.bold(white(message)) + '  ' + muted(hint));
+    out.push(muted('│'));
+    for (let i = 0; i < options.length; i++) {
+      const focused = i === cursor;
+      const arrow   = focused ? ansis.bold(ansis.white('▶')) : ' ';
+      const label   = focused
+        ? ansis.bold(ansis.white(options[i].label))
+        : muted(options[i].label);
+      const desc    = options[i].hint ? '  ' + muted(options[i].hint) : '';
+      out.push(muted('│') + '  ' + arrow + ' ' + label + desc);
+    }
+    out.push(muted('│'));
+    return out;
+  }
+
+  function draw() {
+    const lines = renderLines();
+    if (lastLines > 0) process.stdout.write(`\x1b[${lastLines}A`);
+    for (const l of lines) process.stdout.write('\x1b[2K' + l + '\n');
+    process.stdout.write('\x1b[0J');
+    lastLines = lines.length;
+  }
+
+  function clearBlock() {
+    if (lastLines > 0) {
+      process.stdout.write(`\x1b[${lastLines}A\x1b[0J`);
+      lastLines = 0;
+    }
+  }
+
+  draw();
+
+  return new Promise((resolve, reject) => {
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+
+    function cleanup() {
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdin.removeAllListeners('data');
+    }
+
+    process.stdin.on('data', key => {
+      if (key === KEY.CTRL_C) { cleanup(); process.exit(0); }
+
+      if (key === KEY.ESC) {
+        cleanup();
+        clearBlock();
+        reject(Object.assign(new Error('cancel'), { isCancel: true }));
+        return;
+      }
+
+      if (key === KEY.UP)   cursor = Math.max(0, cursor - 1);
+      if (key === KEY.DOWN) cursor = Math.min(options.length - 1, cursor + 1);
+
+      if (key === KEY.ENTER) {
+        cleanup();
+        clearBlock();
+        resolve(options[cursor].value);
+        return;
+      }
+
+      draw();
+    });
+  });
+}

package/lib/picker.js

@@ -157,7 +157,9 @@ export async function skillPicker({ message, options }) {
       if (key === KEY.ENTER) {
         if (!sel.size) return;
         cleanup();
-        process.stdout.write('\x1b[2K' + success('◆') + '  ' +
+        // Clear entire picker block then write compact confirmation
+        if (lastLines > 0) process.stdout.write(`\x1b[${lastLines}A\x1b[0J`);
+        process.stdout.write(success('◆') + '  ' +
           white(`${sel.size} skill(s) selected`) + '\n');
         resolve([...sel].sort((a, b) => a - b).map(i => options[i].value));
         return;

package/lib/prompts.js

@@ -1,12 +1,11 @@
-import { select, confirm, isCancel } from '@clack/prompts';
+import { confirm, isCancel } from '@clack/prompts';
 import ansis from 'ansis';
 import { skillColor, white, muted, divider } from './theme.js';
 import { skillPicker } from './picker.js';
+import { inlineSelect } from './inlineSelect.js';
 
 export class CliCancel extends Error {}
 
-// Escape/Ctrl+C at any prompt throws CliCancel — hub catches it silently and
-// returns to the main menu (no "Cancelled." noise printed).
 function guard(v) {
   if (isCancel(v)) throw new CliCancel();
   return v;
@@ -15,13 +14,14 @@ function guard(v) {
 export async function pickScope(flags = {}) {
   if (flags.global) return { global: true };
   if (flags.project) return { project: true };
-  const v = guard(await select({
+  const v = await inlineSelect({
     message: 'Select scope',
+    hint: '↑↓ navigate · enter select · esc back',
     options: [
-      { value: 'global',  label: 'Global (~/.claude/skills + ~/.agents/skills)' },
-      { value: 'project', label: 'Project (.claude/skills in current directory)' },
+      { value: 'global',  label: 'Global',  hint: '~/.claude/skills + ~/.agents/skills' },
+      { value: 'project', label: 'Project', hint: '.claude/skills in current directory' },
     ],
-  }));
+  }).catch(e => { if (e?.isCancel) throw new CliCancel(); throw e; });
   return { global: v === 'global' };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-agent-skills",
-  "version": "1.4.1",
+  "version": "1.5.1",
   "description": "Install and manage Pavi's Claude Code agent skills",
   "license": "MIT",
   "type": "module",

package/skills.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "name": "claude-agent-skills",
-  "version": "1.4.1",
+  "version": "1.5.1",
   "skills": [
     "ask-matt",
     "brainstorming",