agent-skill-manager 1.0.0 → 1.1.0

package/CODE_OF_CONDUCT.md

@@ -46,7 +46,7 @@ an individual is officially representing the community in public spaces.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported to the project maintainers via
-[GitHub Issues](https://github.com/luongnv89/skill-manager/issues).
+[GitHub Issues](https://github.com/luongnv89/agent-skill-manager/issues).
 
 All complaints will be reviewed and investigated promptly and fairly.
 

package/CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing to skill-manager
+# Contributing to agent-skill-manager
 
 Thanks for your interest in contributing! This guide will help you get started.
 
@@ -12,8 +12,8 @@ Thanks for your interest in contributing! This guide will help you get started.
 ### Development Setup
 
 ```bash
-git clone https://github.com/luongnv89/skill-manager.git
-cd skill-manager
+git clone https://github.com/luongnv89/agent-skill-manager.git
+cd agent-skill-manager
 bun install
 bun run start        # Launch the TUI
 ```
@@ -29,7 +29,7 @@ bun run typecheck    # Type-check without emitting
 
 ### Reporting Bugs
 
-Open a [bug report](https://github.com/luongnv89/skill-manager/issues/new?template=bug_report.md) with:
+Open a [bug report](https://github.com/luongnv89/agent-skill-manager/issues/new?template=bug_report.md) with:
 
 - Steps to reproduce
 - Expected vs. actual behavior
@@ -37,7 +37,7 @@ Open a [bug report](https://github.com/luongnv89/skill-manager/issues/new?templa
 
 ### Suggesting Features
 
-Open a [feature request](https://github.com/luongnv89/skill-manager/issues/new?template=feature_request.md) describing the problem and your proposed solution.
+Open a [feature request](https://github.com/luongnv89/agent-skill-manager/issues/new?template=feature_request.md) describing the problem and your proposed solution.
 
 ### Submitting Code
 

package/README.md

@@ -2,7 +2,7 @@
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="assets/logo/logo-full.svg" />
     <source media="(prefers-color-scheme: light)" srcset="assets/logo/logo-black.svg" />
-    <img src="assets/logo/logo-full.svg" alt="skill-manager" width="480" />
+    <img src="assets/logo/logo-full.svg" alt="agent-skill-manager" width="560" />
   </picture>
 </p>
 
@@ -25,12 +25,16 @@
 
 ---
 
-**skill-manager** is an interactive terminal UI for managing installed skills across AI coding agents — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [OpenClaw](https://github.com/openclaw), and more. Built with [OpenTUI](https://github.com/nicholasgasior/opentui) and [Bun](https://bun.sh).
+**agent-skill-manager** is an interactive terminal UI for managing installed skills across AI coding agents — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [OpenClaw](https://github.com/openclaw), and more. Built with [OpenTUI](https://github.com/nicholasgasior/opentui) and [Bun](https://bun.sh).
+
+<p align="center">
+  <img src="assets/screenshots/agent-skill-manager.png" alt="agent-skill-manager TUI dashboard" width="800" />
+</p>
 
 ## Features
 
 - **Multi-agent support** — Manage skills for Claude Code, Codex, OpenClaw, and custom agent tools from one TUI
-- **Configurable providers** — Define which agent tool directories to scan via `~/.config/skill-manager/config.json`
+- **Configurable providers** — Define which agent tool directories to scan via `~/.config/agent-skill-manager/config.json`
 - **Global & project scopes** — Filter skills by global (`~/.<tool>/skills/`) or project-level (`./<tool>/skills/`)
 - **Real-time search** — Filter skills by name, description, or provider
 - **Sort** — By name, version, or location
@@ -40,27 +44,52 @@
 
 ## Install
 
+### Quick Install (one command)
+
+```bash
+curl -sSL https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh | bash
+```
+
+Or with wget:
+
+```bash
+wget -qO- https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh | bash
+```
+
+This will automatically install [Bun](https://bun.sh) (if not already installed) and then install `agent-skill-manager` globally.
+
+### Manual Install
+
 **Prerequisites:** [Bun](https://bun.sh) >= 1.0.0
 
 ```bash
 bun install -g agent-skill-manager
 ```
 
-Or run directly from source:
+### From Source
 
 ```bash
-git clone https://github.com/luongnv89/skill-manager.git
-cd skill-manager
+git clone https://github.com/luongnv89/agent-skill-manager.git
+cd agent-skill-manager
 bun install
 bun run start
 ```
 
+### Advanced Options
+
+```bash
+# Download and inspect before running
+curl -sSL https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh -o install.sh
+less install.sh  # review the script
+bash install.sh
+```
+
 ## Usage
 
 ```bash
-skill-manager              # Launch the interactive TUI
-skill-manager --help       # Show help
-skill-manager --version    # Show version
+agent-skill-manager              # Launch the interactive TUI
+agent-skill-manager --help       # Show help
+agent-skill-manager --version    # Show version
 ```
 
 ## Keyboard Shortcuts
@@ -81,7 +110,7 @@ skill-manager --version    # Show version
 
 ## Configuration
 
-On first run, a config file is created at `~/.config/skill-manager/config.json` with default providers:
+On first run, a config file is created at `~/.config/agent-skill-manager/config.json` with default providers:
 
 ```json
 {
@@ -145,9 +174,9 @@ Additional tools can be added via the config file.
 ## Project Structure
 
 ```
-skill-manager/
+agent-skill-manager/
 ├── bin/                    # CLI entry point
-│   └── skill-manager.ts
+│   └── agent-skill-manager.ts
 ├── src/
 │   ├── index.ts            # App bootstrap & keyboard handling
 │   ├── config.ts           # Config loading & saving

package/RELEASE_NOTES.md

@@ -1,31 +1,22 @@
-## v1.0.0 — 2025-03-11
-
-Initial release of **skill-manager** — the universal skill manager for AI coding agents.
+## v1.1.0 — 2026-03-11
 
 ### Features
 
-- Interactive TUI dashboard built with OpenTUI and Bun
-- Multi-agent support: Claude Code, Codex, OpenClaw, and generic Agents
-- Configurable providers via `~/.config/skill-manager/config.json`
-- Global and project scope filtering with Tab cycling
-- Real-time search and sort (by name, version, location)
-- Detailed skill view with SKILL.md frontmatter metadata
-- Safe uninstall with confirmation dialog and full removal plan
-- In-TUI config editor — toggle providers on/off or open in `$EDITOR`
-- CLI entry point with `--help` and `--version` flags
-- Neon green logo suite and brand kit
+- Add one-command install script for `curl | bash` usage (dee8bb2)
+- Add non-interactive CLI mode with `asm` shorthand command (3904bdc)
+- Rebrand project to agent-skill-manager across all files (944c877)
+- Rename package to agent-skill-manager and add version info to help (5fe6ed3)
 
-### Infrastructure
+### Bug Fixes
 
-- Pre-commit hooks (Prettier, TypeScript type-checking)
-- GitHub Actions CI pipeline (type-check + tests)
-- 63 unit tests covering config, scanner, uninstaller, and frontmatter modules
-- OSS-ready: LICENSE, CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, issue/PR templates
+- Handle Bun global bin PATH and create asm/agent-skill-manager aliases in installer (268c2bd)
+- Remove external font import from SVGs for GitHub rendering (c75a985)
 
-### Install
+### Other Changes
 
-```bash
-bun install -g agent-skill-manager
-```
+- Rename bin entry point to agent-skill-manager.ts (8ac0ae1)
+- Add .npmignore to exclude unnecessary files from npm package (8339a45)
+- Add TUI screenshot to README and update logo width (339eb04)
+- Remove obsolete RELEASE_NOTES.md and CLI_PLAN.md (ec0d9a9)
 
-**Full Changelog**: https://github.com/luongnv89/skill-manager/commits/v1.0.0
+**Full Changelog**: https://github.com/luongnv89/agent-skill-manager/compare/v1.0.0...v1.1.0

package/SECURITY.md

@@ -13,7 +13,7 @@ We take security vulnerabilities seriously. If you discover a security issue, pl
 ### How to Report
 
 1. **Do NOT** open a public GitHub issue for security vulnerabilities
-2. Open a [private security advisory](https://github.com/luongnv89/skill-manager/security/advisories/new) on GitHub
+2. Open a [private security advisory](https://github.com/luongnv89/agent-skill-manager/security/advisories/new) on GitHub
 3. Include detailed steps to reproduce the vulnerability
 4. Allow up to 48 hours for an initial response
 

package/bin/agent-skill-manager.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env bun
+
+import { isCLIMode, runCLI } from "../src/cli";
+
+if (isCLIMode(process.argv)) {
+  await runCLI(process.argv);
+} else {
+  // No args — launch interactive TUI
+  await import("../src/index.ts");
+}
+
+export {};

package/docs/ARCHITECTURE.md

@@ -2,11 +2,11 @@
 
 ## Overview
 
-skill-manager is a terminal UI application that scans, displays, and manages skills installed for various AI coding agents. It follows a simple layered architecture: CLI entry → app bootstrap → core modules → TUI views.
+agent-skill-manager is a terminal UI application that scans, displays, and manages skills installed for various AI coding agents. It follows a simple layered architecture: CLI entry → app bootstrap → core modules → TUI views.
 
 ## Components
 
-### CLI Entry (`bin/skill-manager.ts`)
+### CLI Entry (`bin/agent-skill-manager.ts`)
 
 Handles `--help` and `--version` flags, then delegates to the main app entry point.
 
@@ -16,11 +16,11 @@ Initializes the OpenTUI renderer, wires up keyboard handlers, and manages view s
 
 ### Core Modules
 
-| Module               | Responsibility                                              |
-| -------------------- | ----------------------------------------------------------- |
-| `src/config.ts`      | Load/save config from `~/.config/skill-manager/config.json` |
-| `src/scanner.ts`     | Walk provider directories, parse SKILL.md, filter & sort    |
-| `src/uninstaller.ts` | Build removal plans and execute safe deletions              |
+| Module               | Responsibility                                                    |
+| -------------------- | ----------------------------------------------------------------- |
+| `src/config.ts`      | Load/save config from `~/.config/agent-skill-manager/config.json` |
+| `src/scanner.ts`     | Walk provider directories, parse SKILL.md, filter & sort          |
+| `src/uninstaller.ts` | Build removal plans and execute safe deletions                    |
 
 ### Views (`src/views/`)
 

package/docs/CHANGELOG.md

@@ -4,13 +4,37 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [1.1.0] - 2026-03-11
+
+### Added
+
+- One-command install script (`curl | bash`) with automatic Bun installation
+- Non-interactive CLI mode with `asm` shorthand command
+- .npmignore to exclude unnecessary files from npm package
+- TUI screenshot in README
+
+### Fixed
+
+- Bun global bin PATH handling and asm/agent-skill-manager alias creation in installer
+- External font import in SVGs for GitHub rendering
+
+### Changed
+
+- Rebranded project to agent-skill-manager across all files
+- Renamed bin entry point to `agent-skill-manager.ts` to match package name
+- Renamed package to agent-skill-manager with version info in help output
+
+### Removed
+
+- Obsolete CLI_PLAN.md
+
 ## [1.0.0] - 2025-03-11
 
 ### Added
 
 - Interactive TUI dashboard with OpenTUI
 - Multi-agent support: Claude Code, Codex, OpenClaw, and generic Agents
-- Configurable providers via `~/.config/skill-manager/config.json`
+- Configurable providers via `~/.config/agent-skill-manager/config.json`
 - Global and project scope filtering
 - Real-time search and sort (by name, version, location)
 - Detailed skill view with SKILL.md frontmatter metadata

package/docs/DEPLOYMENT.md

@@ -2,14 +2,14 @@
 
 ## Publishing to npm (via Bun)
 
-skill-manager is distributed as a global CLI package.
+agent-skill-manager is distributed as a global CLI package.
 
 ### 1. Bump the version
 
 Update the version in both files:
 
 - `package.json` → `"version"`
-- `bin/skill-manager.ts` → `VERSION` constant
+- `bin/agent-skill-manager.ts` → `VERSION` constant
 
 ### 2. Build and publish
 
@@ -36,8 +36,8 @@ bun install -g agent-skill-manager
 For development or CI environments:
 
 ```bash
-git clone https://github.com/luongnv89/skill-manager.git
-cd skill-manager
+git clone https://github.com/luongnv89/agent-skill-manager.git
+cd agent-skill-manager
 bun install
 bun run start
 ```

package/docs/DEVELOPMENT.md

@@ -8,8 +8,8 @@
 ## Setup
 
 ```bash
-git clone https://github.com/luongnv89/skill-manager.git
-cd skill-manager
+git clone https://github.com/luongnv89/agent-skill-manager.git
+cd agent-skill-manager
 bun install
 ```
 

package/install.sh

@@ -0,0 +1,226 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ============================================================================
+# agent-skill-manager Installer
+# The universal skill manager for AI coding agents.
+#
+# Usage:
+#   curl -sSL https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh | bash
+#   wget -qO- https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh | bash
+# ============================================================================
+
+TOOL_NAME="agent-skill-manager"
+REPO_OWNER="luongnv89"
+REPO_NAME="agent-skill-manager"
+BUN_MIN_VERSION="1.0.0"
+
+# --- Color Output ---
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+info()  { printf "${BLUE}[INFO]${NC}  %s\n" "$*"; }
+ok()    { printf "${GREEN}[ OK ]${NC}  %s\n" "$*"; }
+warn()  { printf "${YELLOW}[WARN]${NC}  %s\n" "$*"; }
+err()   { printf "${RED}[ERR ]${NC}  %s\n" "$*" >&2; }
+die()   { err "$@"; exit 1; }
+
+# --- OS / Arch Detection ---
+detect_os() {
+    local os
+    os="$(uname -s | tr '[:upper:]' '[:lower:]')"
+    case "$os" in
+        linux*)  echo "linux" ;;
+        darwin*) echo "macos" ;;
+        mingw*|msys*|cygwin*) echo "windows" ;;
+        *)       die "Unsupported operating system: $os" ;;
+    esac
+}
+
+detect_arch() {
+    local arch
+    arch="$(uname -m)"
+    case "$arch" in
+        x86_64|amd64)  echo "x86_64" ;;
+        aarch64|arm64) echo "arm64" ;;
+        armv7l)        echo "armv7" ;;
+        *)             die "Unsupported architecture: $arch" ;;
+    esac
+}
+
+# --- Version Comparison ---
+# Returns 0 if $1 >= $2 (semver)
+version_gte() {
+    local IFS=.
+    local i ver1=($1) ver2=($2)
+    for ((i=0; i<${#ver2[@]}; i++)); do
+        local v1="${ver1[i]:-0}"
+        local v2="${ver2[i]:-0}"
+        if ((v1 > v2)); then return 0; fi
+        if ((v1 < v2)); then return 1; fi
+    done
+    return 0
+}
+
+# --- Bun Detection & Installation ---
+check_bun() {
+    if command -v bun &>/dev/null; then
+        local bun_version
+        bun_version="$(bun --version 2>/dev/null || echo "0.0.0")"
+        if version_gte "$bun_version" "$BUN_MIN_VERSION"; then
+            ok "Bun $bun_version found (>= $BUN_MIN_VERSION required)"
+            return 0
+        else
+            warn "Bun $bun_version found but >= $BUN_MIN_VERSION is required"
+            return 1
+        fi
+    else
+        return 1
+    fi
+}
+
+install_bun() {
+    info "Installing Bun..."
+    if command -v curl &>/dev/null; then
+        curl -fsSL https://bun.sh/install | bash
+    elif command -v wget &>/dev/null; then
+        wget -qO- https://bun.sh/install | bash
+    else
+        die "Neither curl nor wget found. Please install one of them first."
+    fi
+
+    # Source bun into current shell
+    local bun_install="${BUN_INSTALL:-$HOME/.bun}"
+    if [ -f "$bun_install/bin/bun" ]; then
+        export BUN_INSTALL="$bun_install"
+        export PATH="$bun_install/bin:$PATH"
+    fi
+
+    if ! command -v bun &>/dev/null; then
+        die "Bun installation completed but 'bun' is not in PATH. Please restart your shell and re-run this script."
+    fi
+
+    ok "Bun $(bun --version) installed"
+}
+
+# --- Ensure Bun global bin is in PATH ---
+ensure_bun_in_path() {
+    local bun_bin="${BUN_INSTALL:-$HOME/.bun}/bin"
+    if [[ ":$PATH:" != *":$bun_bin:"* ]]; then
+        export PATH="$bun_bin:$PATH"
+        info "Added $bun_bin to PATH for this session"
+    fi
+}
+
+# --- Install agent-skill-manager ---
+install_asm() {
+    info "Installing $TOOL_NAME globally via Bun..."
+    bun install -g "$TOOL_NAME"
+    ok "$TOOL_NAME installed globally"
+}
+
+# --- Create command aliases ---
+create_aliases() {
+    local bun_bin="${BUN_INSTALL:-$HOME/.bun}/bin"
+    local bin_target=""
+
+    # Find the actual installed binary (could be skill-manager or agent-skill-manager)
+    for name in skill-manager agent-skill-manager; do
+        if [ -f "$bun_bin/$name" ] || [ -L "$bun_bin/$name" ]; then
+            bin_target="$bun_bin/$name"
+            break
+        fi
+    done
+
+    if [ -z "$bin_target" ]; then
+        warn "Could not find installed binary in $bun_bin"
+        return 1
+    fi
+
+    # Create symlinks for all expected command names
+    for alias_name in agent-skill-manager asm; do
+        local alias_path="$bun_bin/$alias_name"
+        if [ ! -f "$alias_path" ] && [ ! -L "$alias_path" ]; then
+            ln -s "$bin_target" "$alias_path"
+            ok "Created alias: $alias_name"
+        fi
+    done
+}
+
+# --- Verification ---
+verify_installation() {
+    info "Verifying installation..."
+    local found=false
+
+    for cmd in agent-skill-manager asm skill-manager; do
+        if command -v "$cmd" &>/dev/null; then
+            ok "$cmd is available"
+            found=true
+        fi
+    done
+
+    if [ "$found" = false ]; then
+        warn "No commands found in PATH"
+        warn "Add Bun's global bin to your PATH by adding this to your shell profile:"
+        warn "  export PATH=\"\$HOME/.bun/bin:\$PATH\""
+        return 1
+    fi
+
+    return 0
+}
+
+# --- Entry Point ---
+main() {
+    echo ""
+    info "============================================"
+    info " $TOOL_NAME Installer"
+    info "============================================"
+    echo ""
+
+    local os arch
+    os="$(detect_os)"
+    arch="$(detect_arch)"
+    info "OS: $os | Arch: $arch"
+    echo ""
+
+    # Step 1: Ensure Bun is installed
+    if ! check_bun; then
+        install_bun
+    fi
+    echo ""
+
+    # Step 2: Ensure Bun global bin is in PATH
+    ensure_bun_in_path
+
+    # Step 3: Install agent-skill-manager
+    install_asm
+    echo ""
+
+    # Step 4: Create aliases (agent-skill-manager, asm)
+    create_aliases
+    echo ""
+
+    # Step 5: Verify
+    if verify_installation; then
+        echo ""
+        info "============================================"
+        ok "Installation complete!"
+        info "============================================"
+        echo ""
+        info "Get started:"
+        info "  asm                    # Launch interactive TUI (shorthand)"
+        info "  agent-skill-manager    # Launch interactive TUI"
+        info "  asm --help             # Show help"
+        echo ""
+    else
+        echo ""
+        warn "Installation finished but verification had warnings."
+        warn "Try restarting your terminal, then run: agent-skill-manager"
+        echo ""
+    fi
+}
+
+main "$@"

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "agent-skill-manager",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Interactive TUI for managing installed skills for AI coding agents (Claude Code, Codex, OpenClaw, and more)",
   "type": "module",
   "bin": {
-    "skill-manager": "bin/skill-manager.ts"
+    "agent-skill-manager": "bin/agent-skill-manager.ts",
+    "asm": "bin/agent-skill-manager.ts"
   },
   "scripts": {
     "start": "bun run src/index.ts",
@@ -19,7 +20,7 @@
     "bun": ">=1.0.0"
   },
   "keywords": [
-    "skill-manager",
+    "agent-skill-manager",
     "tui",
     "cli",
     "ai-agents",
@@ -30,13 +31,13 @@
   ],
   "author": "luongnv89",
   "license": "MIT",
-  "homepage": "https://github.com/luongnv89/skill-manager#readme",
+  "homepage": "https://github.com/luongnv89/agent-skill-manager#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/luongnv89/skill-manager.git"
+    "url": "git+https://github.com/luongnv89/agent-skill-manager.git"
   },
   "bugs": {
-    "url": "https://github.com/luongnv89/skill-manager/issues"
+    "url": "https://github.com/luongnv89/agent-skill-manager/issues"
   },
   "devDependencies": {
     "bun-types": "^1.3.10"

package/src/cli.ts

@@ -0,0 +1,488 @@
+import {
+  loadConfig,
+  getConfigPath,
+  getDefaultConfig,
+  saveConfig,
+} from "./config";
+import { scanAllSkills, searchSkills, sortSkills } from "./scanner";
+import {
+  buildFullRemovalPlan,
+  executeRemoval,
+  getExistingTargets,
+} from "./uninstaller";
+import {
+  formatSkillTable,
+  formatSkillDetail,
+  formatJSON,
+  ansi,
+} from "./formatter";
+import { VERSION_STRING } from "./utils/version";
+import type { Scope, SortBy } from "./utils/types";
+
+// ─── Arg Parser ─────────────────────────────────────────────────────────────
+
+interface ParsedArgs {
+  command: string | null;
+  subcommand: string | null;
+  positional: string[];
+  flags: {
+    help: boolean;
+    version: boolean;
+    json: boolean;
+    yes: boolean;
+    noColor: boolean;
+    scope: Scope;
+    sort: SortBy;
+  };
+}
+
+export function parseArgs(argv: string[]): ParsedArgs {
+  const args = argv.slice(2); // skip bun and script path
+
+  const result: ParsedArgs = {
+    command: null,
+    subcommand: null,
+    positional: [],
+    flags: {
+      help: false,
+      version: false,
+      json: false,
+      yes: false,
+      noColor: false,
+      scope: "both",
+      sort: "name",
+    },
+  };
+
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+
+    // Flags
+    if (arg === "--help" || arg === "-h") {
+      result.flags.help = true;
+    } else if (arg === "--version" || arg === "-v") {
+      result.flags.version = true;
+    } else if (arg === "--json") {
+      result.flags.json = true;
+    } else if (arg === "--yes" || arg === "-y") {
+      result.flags.yes = true;
+    } else if (arg === "--no-color") {
+      result.flags.noColor = true;
+    } else if (arg === "--scope" || arg === "-s") {
+      i++;
+      const val = args[i];
+      if (val === "global" || val === "project" || val === "both") {
+        result.flags.scope = val;
+      } else {
+        error(`Invalid scope: "${val}". Must be global, project, or both.`);
+        process.exit(2);
+      }
+    } else if (arg === "--sort") {
+      i++;
+      const val = args[i];
+      if (val === "name" || val === "version" || val === "location") {
+        result.flags.sort = val;
+      } else {
+        error(`Invalid sort: "${val}". Must be name, version, or location.`);
+        process.exit(2);
+      }
+    } else if (arg.startsWith("-")) {
+      error(`Unknown option: ${arg}`);
+      console.error(`Run "asm --help" for usage.`);
+      process.exit(2);
+    } else {
+      // Positional: first is command, second is subcommand, rest are positional args
+      if (!result.command) {
+        result.command = arg;
+      } else if (!result.subcommand) {
+        result.subcommand = arg;
+      } else {
+        result.positional.push(arg);
+      }
+    }
+
+    i++;
+  }
+
+  return result;
+}
+
+// ─── Output helpers ─────────────────────────────────────────────────────────
+
+function error(msg: string) {
+  console.error(ansi.red(`Error: ${msg}`));
+}
+
+// ─── Help text ──────────────────────────────────────────────────────────────
+
+function printMainHelp() {
+  console.log(`${ansi.blueBold("agent-skill-manager")} (${ansi.bold("asm")}) ${VERSION_STRING}
+
+Interactive TUI and CLI for managing installed skills for AI coding agents.
+
+${ansi.bold("Usage:")}
+  asm                        Launch interactive TUI
+  asm <command> [options]     Run a CLI command
+
+${ansi.bold("Commands:")}
+  list                   List all discovered skills
+  search <query>         Search skills by name/description/provider
+  inspect <skill-name>   Show detailed info for a skill
+  uninstall <skill-name> Remove a skill (with confirmation)
+  config show            Print current config
+  config path            Print config file path
+  config reset           Reset config to defaults
+  config edit            Open config in $EDITOR
+
+${ansi.bold("Global Options:")}
+  -h, --help             Show help for any command
+  -v, --version          Print version and exit
+  --json                 Output as JSON (list, search, inspect)
+  -s, --scope <scope>    Filter: global, project, or both (default: both)
+  --no-color             Disable ANSI colors
+  --sort <field>         Sort by: name, version, or location (default: name)
+  -y, --yes              Skip confirmation prompts`);
+}
+
+function printListHelp() {
+  console.log(`${ansi.bold("Usage:")} asm list [options]
+
+List all discovered skills.
+
+${ansi.bold("Options:")}
+  --sort <field>     Sort by: name, version, or location (default: name)
+  -s, --scope <s>    Filter: global, project, or both (default: both)
+  --json             Output as JSON array
+  --no-color         Disable ANSI colors`);
+}
+
+function printSearchHelp() {
+  console.log(`${ansi.bold("Usage:")} asm search <query> [options]
+
+Search skills by name, description, or provider.
+
+${ansi.bold("Options:")}
+  --sort <field>     Sort by: name, version, or location (default: name)
+  -s, --scope <s>    Filter: global, project, or both (default: both)
+  --json             Output as JSON array
+  --no-color         Disable ANSI colors`);
+}
+
+function printInspectHelp() {
+  console.log(`${ansi.bold("Usage:")} asm inspect <skill-name> [options]
+
+Show detailed information for a skill. The <skill-name> is the directory name.
+
+${ansi.bold("Options:")}
+  -s, --scope <s>    Filter: global, project, or both (default: both)
+  --json             Output as JSON object
+  --no-color         Disable ANSI colors`);
+}
+
+function printUninstallHelp() {
+  console.log(`${ansi.bold("Usage:")} asm uninstall <skill-name> [options]
+
+Remove a skill and its associated rule files.
+
+${ansi.bold("Options:")}
+  -y, --yes          Skip confirmation prompt
+  -s, --scope <s>    Filter: global, project, or both (default: both)
+  --no-color         Disable ANSI colors`);
+}
+
+function printConfigHelp() {
+  console.log(`${ansi.bold("Usage:")} asm config <subcommand>
+
+Manage configuration.
+
+${ansi.bold("Subcommands:")}
+  show     Print current config as JSON
+  path     Print config file path
+  reset    Reset config to defaults (with confirmation)
+  edit     Open config in $EDITOR`);
+}
+
+// ─── Command Handlers ───────────────────────────────────────────────────────
+
+async function cmdList(args: ParsedArgs) {
+  if (args.flags.help) {
+    printListHelp();
+    return;
+  }
+
+  const config = await loadConfig();
+  const allSkills = await scanAllSkills(config, args.flags.scope);
+  const sorted = sortSkills(allSkills, args.flags.sort);
+
+  if (args.flags.json) {
+    console.log(formatJSON(sorted));
+  } else {
+    console.log(formatSkillTable(sorted));
+  }
+}
+
+async function cmdSearch(args: ParsedArgs) {
+  if (args.flags.help) {
+    printSearchHelp();
+    return;
+  }
+
+  const query = args.subcommand;
+  if (!query) {
+    error("Missing required argument: <query>");
+    console.error(`Run "asm search --help" for usage.`);
+    process.exit(2);
+  }
+
+  const config = await loadConfig();
+  const allSkills = await scanAllSkills(config, args.flags.scope);
+  const filtered = searchSkills(allSkills, query);
+  const sorted = sortSkills(filtered, args.flags.sort);
+
+  if (args.flags.json) {
+    console.log(formatJSON(sorted));
+  } else {
+    console.log(formatSkillTable(sorted));
+  }
+}
+
+async function cmdInspect(args: ParsedArgs) {
+  if (args.flags.help) {
+    printInspectHelp();
+    return;
+  }
+
+  const skillName = args.subcommand;
+  if (!skillName) {
+    error("Missing required argument: <skill-name>");
+    console.error(`Run "asm inspect --help" for usage.`);
+    process.exit(2);
+  }
+
+  const config = await loadConfig();
+  const allSkills = await scanAllSkills(config, args.flags.scope);
+  const matches = allSkills.filter((s) => s.dirName === skillName);
+
+  if (matches.length === 0) {
+    error(`Skill "${skillName}" not found.`);
+    process.exit(1);
+  }
+
+  if (args.flags.json) {
+    console.log(formatJSON(matches.length === 1 ? matches[0] : matches));
+  } else {
+    for (let i = 0; i < matches.length; i++) {
+      if (i > 0) console.log("\n" + "─".repeat(40) + "\n");
+      console.log(formatSkillDetail(matches[i]));
+    }
+  }
+}
+
+async function cmdUninstall(args: ParsedArgs) {
+  if (args.flags.help) {
+    printUninstallHelp();
+    return;
+  }
+
+  const skillName = args.subcommand;
+  if (!skillName) {
+    error("Missing required argument: <skill-name>");
+    console.error(`Run "asm uninstall --help" for usage.`);
+    process.exit(2);
+  }
+
+  const config = await loadConfig();
+  const allSkills = await scanAllSkills(config, args.flags.scope);
+  const plan = buildFullRemovalPlan(skillName, allSkills, config);
+
+  const existing = await getExistingTargets(plan);
+  if (existing.length === 0) {
+    error(`Skill "${skillName}" not found or nothing to remove.`);
+    process.exit(1);
+  }
+
+  // Show removal plan
+  console.error(ansi.bold("Removal plan:"));
+  for (const target of existing) {
+    console.error(`  ${ansi.red("•")} ${target}`);
+  }
+
+  if (!args.flags.yes) {
+    // Interactive confirmation
+    if (!process.stdin.isTTY) {
+      error(
+        "Cannot prompt for confirmation in non-interactive mode. Use --yes to skip.",
+      );
+      process.exit(2);
+    }
+    process.stderr.write(`\n${ansi.bold("Proceed with removal?")} [y/N] `);
+    const answer = await readLine();
+    if (answer.toLowerCase() !== "y" && answer.toLowerCase() !== "yes") {
+      console.error("Aborted.");
+      process.exit(0);
+    }
+  }
+
+  const log = await executeRemoval(plan);
+  for (const entry of log) {
+    console.error(entry);
+  }
+  console.error(ansi.green("\nDone."));
+}
+
+function readLine(): Promise<string> {
+  return new Promise((resolve) => {
+    let data = "";
+    process.stdin.setEncoding("utf-8");
+    process.stdin.on("data", (chunk: string) => {
+      data += chunk;
+      if (data.includes("\n")) {
+        process.stdin.removeAllListeners("data");
+        resolve(data.trim());
+      }
+    });
+    process.stdin.resume();
+  });
+}
+
+async function cmdConfig(args: ParsedArgs) {
+  if (args.flags.help) {
+    printConfigHelp();
+    return;
+  }
+
+  const sub = args.subcommand;
+
+  if (!sub) {
+    error("Missing subcommand. Use: show, path, reset, or edit.");
+    console.error(`Run "asm config --help" for usage.`);
+    process.exit(2);
+  }
+
+  switch (sub) {
+    case "show": {
+      const config = await loadConfig();
+      console.log(formatJSON(config));
+      break;
+    }
+    case "path": {
+      console.log(getConfigPath());
+      break;
+    }
+    case "reset": {
+      if (!args.flags.yes) {
+        if (!process.stdin.isTTY) {
+          error(
+            "Cannot prompt for confirmation in non-interactive mode. Use --yes to skip.",
+          );
+          process.exit(2);
+        }
+        process.stderr.write(
+          `${ansi.bold("Reset config to defaults?")} [y/N] `,
+        );
+        const answer = await readLine();
+        if (answer.toLowerCase() !== "y" && answer.toLowerCase() !== "yes") {
+          console.error("Aborted.");
+          process.exit(0);
+        }
+      }
+      const defaults = getDefaultConfig();
+      await saveConfig(defaults);
+      console.error(ansi.green("Config reset to defaults."));
+      break;
+    }
+    case "edit": {
+      const editor = process.env.VISUAL || process.env.EDITOR || "vi";
+      const configPath = getConfigPath();
+      // Ensure config file exists
+      await loadConfig();
+      const proc = Bun.spawn([editor, configPath], {
+        stdin: "inherit",
+        stdout: "inherit",
+        stderr: "inherit",
+      });
+      await proc.exited;
+      break;
+    }
+    default: {
+      error(
+        `Unknown config subcommand: "${sub}". Use: show, path, reset, or edit.`,
+      );
+      process.exit(2);
+    }
+  }
+}
+
+// ─── Main CLI dispatcher ────────────────────────────────────────────────────
+
+export async function runCLI(argv: string[]): Promise<void> {
+  const args = parseArgs(argv);
+
+  // Apply --no-color
+  if (args.flags.noColor) {
+    (globalThis as any).__CLI_NO_COLOR = true;
+  }
+
+  // --version at top level
+  if (args.flags.version) {
+    console.log(`asm ${VERSION_STRING}`);
+    return;
+  }
+
+  // --help at top level (no command)
+  if (!args.command && args.flags.help) {
+    printMainHelp();
+    return;
+  }
+
+  // No command → return null to signal TUI launch
+  if (!args.command) {
+    return;
+  }
+
+  switch (args.command) {
+    case "list":
+      await cmdList(args);
+      break;
+    case "search":
+      await cmdSearch(args);
+      break;
+    case "inspect":
+      await cmdInspect(args);
+      break;
+    case "uninstall":
+      await cmdUninstall(args);
+      break;
+    case "config":
+      await cmdConfig(args);
+      break;
+    default:
+      error(`Unknown command: "${args.command}"`);
+      console.error(`Run "asm --help" for usage.`);
+      process.exit(2);
+  }
+}
+
+// ─── Check if CLI mode should run ──────────────────────────────────────────
+
+export function isCLIMode(argv: string[]): boolean {
+  const args = argv.slice(2);
+  if (args.length === 0) return false;
+
+  // Known commands
+  const commands = ["list", "search", "inspect", "uninstall", "config"];
+  const first = args[0];
+
+  // If the first arg is a known command, it's CLI mode
+  if (commands.includes(first)) return true;
+
+  // --help and --version are handled in CLI mode too
+  if (first === "--help" || first === "-h") return true;
+  if (first === "--version" || first === "-v") return true;
+
+  // Unknown flags/commands → CLI mode (will show error)
+  if (first.startsWith("-") || first.length > 0) return true;
+
+  return false;
+}

package/src/config.ts

@@ -4,7 +4,7 @@ import { homedir } from "os";
 import type { AppConfig, ProviderConfig } from "./utils/types";
 
 const HOME = homedir();
-const CONFIG_DIR = join(HOME, ".config", "skill-manager");
+const CONFIG_DIR = join(HOME, ".config", "agent-skill-manager");
 const CONFIG_PATH = join(CONFIG_DIR, "config.json");
 
 const DEFAULT_PROVIDERS: ProviderConfig[] = [

package/src/formatter.ts

@@ -0,0 +1,92 @@
+import type { SkillInfo } from "./utils/types";
+
+// ─── Color helpers ──────────────────────────────────────────────────────────
+
+const useColor = (): boolean => {
+  if (process.env.NO_COLOR !== undefined) return false;
+  if ((globalThis as any).__CLI_NO_COLOR) return false;
+  if (!process.stdout.isTTY) return false;
+  return true;
+};
+
+const ansi = {
+  bold: (s: string) => (useColor() ? `\x1b[1m${s}\x1b[0m` : s),
+  cyan: (s: string) => (useColor() ? `\x1b[36m${s}\x1b[0m` : s),
+  green: (s: string) => (useColor() ? `\x1b[32m${s}\x1b[0m` : s),
+  yellow: (s: string) => (useColor() ? `\x1b[33m${s}\x1b[0m` : s),
+  dim: (s: string) => (useColor() ? `\x1b[2m${s}\x1b[0m` : s),
+  red: (s: string) => (useColor() ? `\x1b[31m${s}\x1b[0m` : s),
+  blueBold: (s: string) => (useColor() ? `\x1b[1m\x1b[34m${s}\x1b[0m` : s),
+};
+
+export { ansi };
+
+// ─── Table formatter ────────────────────────────────────────────────────────
+
+export function formatSkillTable(skills: SkillInfo[]): string {
+  if (skills.length === 0) {
+    return "No skills found.";
+  }
+
+  const headers = ["Name", "Version", "Provider", "Scope", "Type", "Path"];
+
+  const rows = skills.map((s) => [
+    s.name,
+    s.version,
+    s.providerLabel,
+    s.scope,
+    s.isSymlink ? "symlink" : "directory",
+    s.path,
+  ]);
+
+  // Calculate column widths
+  const widths = headers.map((h, i) =>
+    Math.max(h.length, ...rows.map((r) => r[i].length)),
+  );
+
+  const pad = (str: string, width: number) => str.padEnd(width);
+
+  const headerLine = headers.map((h, i) => pad(h, widths[i])).join("  ");
+  const separator = widths.map((w) => "─".repeat(w)).join("──");
+  const dataLines = rows.map((row) =>
+    row.map((cell, i) => pad(cell, widths[i])).join("  "),
+  );
+
+  return [
+    useColor() ? ansi.bold(headerLine) : headerLine,
+    separator,
+    ...dataLines,
+  ].join("\n");
+}
+
+// ─── Detail formatter ───────────────────────────────────────────────────────
+
+export function formatSkillDetail(skill: SkillInfo): string {
+  const lines: string[] = [];
+  const label = (key: string, value: string) =>
+    `${useColor() ? ansi.bold(key + ":") : key + ":"} ${value}`;
+
+  lines.push(label("Name", skill.name));
+  lines.push(label("Version", skill.version));
+  lines.push(label("Provider", skill.providerLabel));
+  lines.push(label("Scope", skill.scope));
+  lines.push(label("Location", skill.location));
+  lines.push(label("Path", skill.path));
+  lines.push(label("Type", skill.isSymlink ? "symlink" : "directory"));
+  if (skill.isSymlink && skill.symlinkTarget) {
+    lines.push(label("Symlink Target", skill.symlinkTarget));
+  }
+  lines.push(label("File Count", String(skill.fileCount)));
+  if (skill.description) {
+    lines.push("");
+    lines.push(label("Description", skill.description));
+  }
+
+  return lines.join("\n");
+}
+
+// ─── JSON formatter ─────────────────────────────────────────────────────────
+
+export function formatJSON(data: unknown): string {
+  return JSON.stringify(data, null, 2);
+}

package/src/uninstaller.ts

@@ -122,7 +122,7 @@ async function removeAgentsMdBlock(
   let content = await readFile(filePath, "utf-8");
 
   // Try both new and old marker formats for backward compatibility
-  for (const prefix of ["skill-manager", "pskills"]) {
+  for (const prefix of ["agent-skill-manager", "skill-manager", "pskills"]) {
     const startMarker = `<!-- ${prefix}: ${skillName} -->`;
     const endMarker = `<!-- /${prefix}: ${skillName} -->`;
 
@@ -213,6 +213,7 @@ export async function getExistingTargets(plan: RemovalPlan): Promise<string[]> {
       const content = await readFile(block.file, "utf-8");
       // Check both new and old marker formats
       if (
+        content.includes(`<!-- agent-skill-manager: ${block.skillName} -->`) ||
         content.includes(`<!-- skill-manager: ${block.skillName} -->`) ||
         content.includes(`<!-- pskills: ${block.skillName} -->`)
       ) {

package/src/views/dashboard.ts

@@ -52,7 +52,7 @@ export function createDashboard(
   // ASCII banner
   const banner = new ASCIIFontRenderable(ctx, {
     id: "banner",
-    text: "skill-manager",
+    text: "agent-skill-manager",
     color: theme.accent,
   });
   root.add(banner);

package/bin/skill-manager.ts

@@ -1,46 +0,0 @@
-#!/usr/bin/env bun
-
-import { VERSION, VERSION_STRING } from "../src/utils/version";
-
-const arg = process.argv[2];
-
-if (arg === "--help" || arg === "-h") {
-  console.log(`\x1b[1m\x1b[36mskill-manager\x1b[0m ${VERSION_STRING}
-
-Interactive TUI for managing installed skills for AI coding agents (Claude Code, Codex, OpenClaw, and more).
-
-\x1b[1mUsage:\x1b[0m
-  skill-manager              Launch the interactive TUI dashboard
-  skill-manager --help       Show this help message
-  skill-manager --version    Show version
-
-\x1b[1mRequirements:\x1b[0m
-  Bun >= 1.0.0  (https://bun.sh)
-
-\x1b[1mConfig:\x1b[0m
-  ~/.config/skill-manager/config.json
-
-\x1b[1mTUI Keybindings:\x1b[0m
-  ↑/↓ or j/k   Navigate skill list
-  Enter         View skill details
-  d             Uninstall selected skill
-  /             Search / filter skills
-  Esc           Back / clear filter / close dialog
-  Tab           Cycle scope: Global → Project → Both
-  s             Cycle sort: Name → Version → Location
-  r             Refresh / rescan skills
-  c             Open configuration
-  q             Quit
-  ?             Toggle help overlay`);
-  process.exit(0);
-}
-
-if (arg === "--version" || arg === "-v") {
-  console.log(`skill-manager ${VERSION_STRING}`);
-  process.exit(0);
-}
-
-// Launch the TUI
-await import("../src/index.ts");
-
-export {};