@leeovery/claude-manager 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lee Overy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,244 @@
+<h1 align="center">Claude Manager</h1>
+
+<p align="center">
+  <strong>npm Package for Managing Claude Code Skills & Commands</strong>
+</p>
+
+<p align="center">
+  <a href="#about">About</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#how-it-works">How It Works</a> •
+  <a href="#cli-commands">CLI Commands</a> •
+  <a href="#creating-plugins">Creating Plugins</a> •
+  <a href="#available-plugins">Available Plugins</a> •
+  <a href="#troubleshooting">Troubleshooting</a>
+</p>
+
+---
+
+## Versions
+
+| Version | Package Manager | Status | Branch |
+|---------|----------------|--------|--------|
+| 2.x | npm | **Active** | `main` |
+| 1.x | Composer | Deprecated | [`v1`](https://github.com/leeovery/claude-manager/tree/v1) |
+
+> **Note:** This package is installed automatically as a dependency of plugins.
+> To migrate from v1, update your plugins to their v2 versions (npm-based).
+
+---
+
+## About
+
+Claude Manager is an npm package that automatically manages [Claude Code](https://claude.ai/code) skills, commands, agents, and hooks across your projects.
+
+**What it does:**
+- Automatically installs skills, commands, agents, and hooks from plugin packages into your project's `.claude/` directory
+- Copies assets so they're committed to your repository and available immediately
+- Works with any project that has a `package.json` (Node.js, Laravel, Nuxt, etc.)
+- Provides CLI tools for listing and managing installed plugins
+
+**Why use it?**
+
+Instead of manually copying skill files between projects, you can install them as npm packages and let the manager handle the rest. Update a skill package once, run `npm update`, and all your projects get the improvements.
+
+## Installation
+
+The manager is typically installed automatically as a dependency of plugin packages. When you install a Claude plugin:
+
+```bash
+npm install @your-org/claude-your-plugin
+```
+
+The manager will:
+1. Install itself (as a dependency of the plugin)
+2. Add a `prepare` hook to your `package.json`
+3. Copy the plugin's assets to `.claude/`
+
+That's it. Future `npm install` and `npm update` runs will automatically sync all plugins.
+
+## How It Works
+
+1. Plugin packages have `@leeovery/claude-manager` as a dependency
+2. Plugins register themselves via their `postinstall` script
+3. The manager copies skills, commands, agents, and hooks to `.claude/`
+4. A manifest (`.claude/.plugins-manifest.json`) tracks what's installed
+5. A `prepare` hook ensures plugins sync on both `npm install` and `npm update`
+6. Claude Code discovers them automatically
+
+**After installation, your project structure looks like:**
+
+```
+your-project/
+├── .claude/
+│   ├── .plugins-manifest.json
+│   ├── skills/
+│   │   └── laravel-actions/
+│   │       └── skill.md
+│   ├── commands/
+│   │   └── artisan-make.md
+│   ├── agents/
+│   │   └── code-reviewer.md
+│   └── hooks/
+│       └── pre-commit.sh
+├── node_modules/
+│   └── @your-org/
+│       └── claude-your-plugin/
+└── package.json
+```
+
+## CLI Commands
+
+The manager provides a CLI tool for managing plugins:
+
+| Command | Description |
+|---------|-------------|
+| `npx claude-plugins list` | Show all installed plugins and their assets |
+| `npx claude-plugins install` | Sync all plugins from manifest (runs automatically) |
+| `npx claude-plugins add <package>` | Manually add a plugin |
+| `npx claude-plugins remove <package>` | Remove a plugin and its assets |
+
+## Creating Plugins
+
+Want to create your own skill or command packages?
+
+### Plugin Requirements
+
+1. Have `@leeovery/claude-manager` as a dependency
+2. Add a `postinstall` script that calls `claude-plugins add`
+3. Include asset directories (`skills/`, `commands/`, `agents/`, `hooks/`)
+
+### Example package.json
+
+```json
+{
+    "name": "@your-org/claude-your-skills",
+    "version": "1.0.0",
+    "description": "Your custom skills for Claude Code",
+    "license": "MIT",
+    "dependencies": {
+        "@leeovery/claude-manager": "^2.0.0"
+    },
+    "scripts": {
+        "postinstall": "claude-plugins add"
+    }
+}
+```
+
+### Plugin Structure
+
+```
+your-plugin/
+├── skills/
+│   ├── skill-one/
+│   │   └── skill.md
+│   └── skill-two/
+│       └── skill.md
+├── commands/
+│   ├── command-one.md
+│   └── command-two.md
+├── agents/
+│   └── agent-one.md
+├── hooks/
+│   └── pre-commit.sh
+└── package.json
+```
+
+The manager auto-discovers `skills/`, `commands/`, `agents/`, and `hooks/` directories—no additional configuration needed.
+
+## Available Plugins
+
+| Package | Description |
+|---------|-------------|
+| Coming soon | Be the first to create a plugin! |
+
+## Manifest
+
+The manager tracks installed plugins in `.claude/.plugins-manifest.json`:
+
+```json
+{
+  "plugins": {
+    "@your-org/claude-laravel": {
+      "version": "1.0.0",
+      "files": [
+        "skills/laravel-actions",
+        "commands/artisan-make.md"
+      ]
+    }
+  }
+}
+```
+
+This file should be committed to your repository. It ensures:
+- Plugins are synced correctly on `npm install` and `npm update`
+- Old files are cleaned up when plugins are updated or removed
+- You can see what's installed at a glance
+
+## Troubleshooting
+
+### Assets not copied
+
+Run the install command manually:
+
+```bash
+npx claude-plugins install
+```
+
+### Skills not showing in Claude Code
+
+Check that `.claude/` directories exist and contain files:
+
+```bash
+ls -la .claude/skills/
+ls -la .claude/commands/
+ls -la .claude/agents/
+ls -la .claude/hooks/
+```
+
+### Plugin not detected
+
+Verify the plugin's package.json has:
+- `@leeovery/claude-manager` as a dependency
+- A `postinstall` script that calls `claude-plugins add`
+- A `skills/`, `commands/`, `agents/`, or `hooks/` directory with content
+
+### Prepare hook not added
+
+If your project's `package.json` doesn't have the prepare hook, add it manually:
+
+```json
+{
+  "scripts": {
+    "prepare": "claude-plugins install"
+  }
+}
+```
+
+This ensures plugins sync on both `npm install` and `npm update`.
+
+## Requirements
+
+- Node.js >= 18.0.0
+- npm, pnpm, yarn, or bun
+
+## Contributing
+
+Contributions are welcome! Whether it's:
+
+- Bug fixes
+- Documentation improvements
+- New features
+- Discussion about approaches
+
+Please open an issue first to discuss significant changes.
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+<p align="center">
+  <sub>Built by <a href="https://github.com/leeovery">Lee Overy</a></sub>
+</p>

package/dist/chunk-2SM5GQ6P.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+// src/lib/hooks.ts
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+var HOOK_COMMAND = "claude-plugins install";
+var HOOK_NAME = "prepare";
+function injectPrepareHook(projectRoot) {
+  const packageJsonPath = join(projectRoot, "package.json");
+  if (!existsSync(packageJsonPath)) {
+    return false;
+  }
+  try {
+    const content = readFileSync(packageJsonPath, "utf-8");
+    const pkg = JSON.parse(content);
+    if (!pkg.scripts) {
+      pkg.scripts = {};
+    }
+    const existingHook = pkg.scripts[HOOK_NAME];
+    if (existingHook?.includes(HOOK_COMMAND)) {
+      return false;
+    }
+    if (existingHook) {
+      pkg.scripts[HOOK_NAME] = `${existingHook} && ${HOOK_COMMAND}`;
+    } else {
+      pkg.scripts[HOOK_NAME] = HOOK_COMMAND;
+    }
+    writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + "\n");
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export {
+  injectPrepareHook
+};
+//# sourceMappingURL=chunk-2SM5GQ6P.js.map

package/dist/chunk-2SM5GQ6P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/hooks.ts"],"sourcesContent":["import { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nconst HOOK_COMMAND = 'claude-plugins install';\n// Use 'prepare' instead of 'postinstall' because prepare runs after BOTH:\n// - npm install\n// - npm update\n// This ensures plugins are always synced regardless of which command is used.\nconst HOOK_NAME = 'prepare';\n\ninterface PackageJson {\n  scripts?: Record<string, string>;\n  [key: string]: unknown;\n}\n\nexport function injectPrepareHook(projectRoot: string): boolean {\n  const packageJsonPath = join(projectRoot, 'package.json');\n\n  if (!existsSync(packageJsonPath)) {\n    return false;\n  }\n\n  try {\n    const content = readFileSync(packageJsonPath, 'utf-8');\n    const pkg: PackageJson = JSON.parse(content);\n\n    if (!pkg.scripts) {\n      pkg.scripts = {};\n    }\n\n    const existingHook = pkg.scripts[HOOK_NAME];\n\n    // Check if already has our hook\n    if (existingHook?.includes(HOOK_COMMAND)) {\n      return false; // Already installed\n    }\n\n    // Add or append to hook\n    if (existingHook) {\n      pkg.scripts[HOOK_NAME] = `${existingHook} && ${HOOK_COMMAND}`;\n    } else {\n      pkg.scripts[HOOK_NAME] = HOOK_COMMAND;\n    }\n\n    // Write back with same formatting\n    writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\\n');\n\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport function hasPrepareHook(projectRoot: string): boolean {\n  const packageJsonPath = join(projectRoot, 'package.json');\n\n  if (!existsSync(packageJsonPath)) {\n    return false;\n  }\n\n  try {\n    const content = readFileSync(packageJsonPath, 'utf-8');\n    const pkg: PackageJson = JSON.parse(content);\n\n    return pkg.scripts?.[HOOK_NAME]?.includes(HOOK_COMMAND) ?? false;\n  } catch {\n    return false;\n  }\n}\n\nexport function removePrepareHook(projectRoot: string): boolean {\n  const packageJsonPath = join(projectRoot, 'package.json');\n\n  if (!existsSync(packageJsonPath)) {\n    return false;\n  }\n\n  try {\n    const content = readFileSync(packageJsonPath, 'utf-8');\n    const pkg: PackageJson = JSON.parse(content);\n\n    if (!pkg.scripts?.[HOOK_NAME]) {\n      return false;\n    }\n\n    const hook = pkg.scripts[HOOK_NAME];\n\n    if (!hook.includes(HOOK_COMMAND)) {\n      return false;\n    }\n\n    // Remove our hook from the script\n    let newHook = hook\n      .replace(` && ${HOOK_COMMAND}`, '')\n      .replace(`${HOOK_COMMAND} && `, '')\n      .replace(HOOK_COMMAND, '');\n\n    if (newHook.trim() === '') {\n      delete pkg.scripts[HOOK_NAME];\n    } else {\n      pkg.scripts[HOOK_NAME] = newHook.trim();\n    }\n\n    // Clean up empty scripts object\n    if (Object.keys(pkg.scripts).length === 0) {\n      delete pkg.scripts;\n    }\n\n    writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\\n');\n\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n"],"mappings":";;;AAAA,SAAS,YAAY,cAAc,qBAAqB;AACxD,SAAS,YAAY;AAErB,IAAM,eAAe;AAKrB,IAAM,YAAY;AAOX,SAAS,kBAAkB,aAA8B;AAC9D,QAAM,kBAAkB,KAAK,aAAa,cAAc;AAExD,MAAI,CAAC,WAAW,eAAe,GAAG;AAChC,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,UAAU,aAAa,iBAAiB,OAAO;AACrD,UAAM,MAAmB,KAAK,MAAM,OAAO;AAE3C,QAAI,CAAC,IAAI,SAAS;AAChB,UAAI,UAAU,CAAC;AAAA,IACjB;AAEA,UAAM,eAAe,IAAI,QAAQ,SAAS;AAG1C,QAAI,cAAc,SAAS,YAAY,GAAG;AACxC,aAAO;AAAA,IACT;AAGA,QAAI,cAAc;AAChB,UAAI,QAAQ,SAAS,IAAI,GAAG,YAAY,OAAO,YAAY;AAAA,IAC7D,OAAO;AACL,UAAI,QAAQ,SAAS,IAAI;AAAA,IAC3B;AAGA,kBAAc,iBAAiB,KAAK,UAAU,KAAK,MAAM,CAAC,IAAI,IAAI;AAElE,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}