@gifflet/ccmd 1.0.0-test.1

package/README.md

@@ -0,0 +1,120 @@
+# ccmd - Claude Command Manager
+
+[![Go Version](https://img.shields.io/badge/Go-1.23+-00ADD8.svg)](https://go.dev)
+[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Go Report Card](https://goreportcard.com/badge/github.com/gifflet/ccmd)](https://goreportcard.com/report/github.com/gifflet/ccmd)
+[![Sponsor](https://img.shields.io/badge/sponsor-30363D?logo=GitHub-Sponsors&color=5c5c5c)](https://github.com/sponsors/gifflet)
+
+Simple command-line tool for managing custom commands in Claude Code. Install and share commands from Git repositories with the ease of a package manager.
+
+## Why ccmd?
+
+Managing custom Claude Code commands across multiple projects can be challenging. ccmd solves this by treating commands as versioned, reusable packages:
+
+- **Keep commands out of your codebase**: Store command definitions (.md files and AI context) in separate repositories, keeping your project repositories clean
+- **Version control**: Each command has its own version, allowing you to use different versions in different projects
+- **Reusability**: Install the same command in multiple projects without duplication
+- **Easy sharing**: Share commands with your team or the community through Git repositories
+- **Simple management**: Install, update, and remove commands with familiar package manager semantics
+
+Think of ccmd as "npm for Claude Code commands" - centralize your AI tooling configurations and use them anywhere.
+
+## Installation
+
+```bash
+go install github.com/gifflet/ccmd/cmd/ccmd@latest
+```
+
+## Quick Start
+
+### 1. Initialize your project
+```bash
+cd your-project
+ccmd init
+```
+
+### 2. Install a demo command
+```bash
+ccmd install gifflet/hello-world
+```
+
+### 3. Use it in Claude Code
+```
+/hello-world
+```
+
+That's it! You've just installed and used your first ccmd command.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `ccmd init` | Initialize a new command project |
+| `ccmd install <repo>` | Install a command from a Git repository |
+| `ccmd install` | Install all commands from ccmd.yaml |
+| `ccmd list` | List installed commands |
+| `ccmd update <command>` | Update a specific command |
+| `ccmd remove <command>` | Remove an installed command |
+| `ccmd search <keyword>` | Search for commands in the registry |
+| `ccmd info <command>` | Show detailed command information |
+
+> For detailed usage and options, see [commands reference](docs/commands.md)
+
+## Creating Your Own Commands
+
+Creating a command for ccmd is simple. Your repository needs:
+
+1. **ccmd.yaml** - Command metadata (created by `ccmd init`)
+2. **index.md** - Command instructions for Claude
+
+### Quick Start
+
+```bash
+mkdir my-command && cd my-command
+ccmd init  # Creates ccmd.yaml interactively
+```
+
+### Example Structure
+
+```
+my-command/
+├── ccmd.yaml          # Command metadata (required)
+└── index.md           # Command for Claude (required)
+```
+
+### Example ccmd.yaml
+
+```yaml
+name: my-command
+version: 1.0.0
+description: Automates tasks in Claude Code
+author: Your Name
+repository: https://github.com/username/my-command
+entry: index.md  # Optional, defaults to index.md
+```
+
+> For complete guide with examples, see [Creating Commands](docs/creating-commands.md)
+
+## Example Commands
+
+Here are some commands you can install and try:
+
+- **hello-world**: Simple demo command
+  ```bash
+  ccmd install https://github.com/gifflet/hello-world
+  ```
+
+## Documentation
+
+- **[Full Documentation](docs/)** - Complete guides and references
+- **[Command Creation Guide](docs/creating-commands.md)** - Create your own commands
+
+## Community
+
+- **Issues**: [GitHub Issues](https://github.com/gifflet/ccmd/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/gifflet/ccmd/discussions)
+- **Contributing**: See [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details

package/index.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+const path = require('node:path');
+const childProcess = require('node:child_process');
+const fsPromises = require('node:fs/promises');
+
+// Mapping from Node's `process.arch` to Golang's `$GOARCH`
+const ARCH_MAPPING = {
+  x64: 'amd64',
+  arm64: 'arm64',
+};
+const PLATFORM_MACOS = 'darwin';
+// Mapping between Node's `process.platform` to Golang's
+const PLATFORM_MAPPING = {
+  [PLATFORM_MACOS]: PLATFORM_MACOS,
+  linux: 'linux',
+  win32: 'windows',
+};
+/** @type {string?} */
+let fullPath = null;
+
+/**
+ * @return {Promise<string>}
+ */
+export async function findCcmdBinary() {
+  if (fullPath) {
+    // return the previously cached value
+    return fullPath;
+  }
+
+  const binaryName = `ccmd${process.platform === 'win32' ? '.exe' : ''}`;
+  const binaryRoot = path.join(__dirname, 'dist');
+  const goPlatform = PLATFORM_MAPPING[process.platform];
+  const goArch = ARCH_MAPPING[process.arch];
+  if (goPlatform && goArch) {
+    const sysFolderName = `ccmd-${goPlatform}-${goArch}_${goPlatform}_${goArch}`;
+    fullPath = path.join(binaryRoot, sysFolderName, binaryName);
+    try {
+      await fsPromises.access(fullPath, fsPromises.constants.R_OK);
+    } catch (ign) {
+      fullPath = null;
+    }
+  }
+  if (!fullPath) {
+    throw new Error(
+      `There is no precompiled ccmd binary for ${process.platform}@${process.arch} at '${binaryRoot}'`
+    );
+  }
+  return fullPath;
+}
+
+/**
+ * @returns {Promise<void>}
+ */
+async function main() {
+  const binaryPath = await findCcmdBinary();
+  const child = childProcess.spawn(binaryPath, process.argv.slice(2), {
+    cwd: process.cwd(),
+    env: process.env,
+    stdio: [process.stdin, process.stdout, process.stderr],
+  });
+  await new Promise((resolve, reject) => {
+    child.once('error', reject);
+    child.once('exit', (code) => process.exit(code));
+  });
+}
+
+
+if (require.main === module) {
+  (async () => await main())();
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@gifflet/ccmd",
+  "version": "1.0.0-test.1",
+  "description": "Simple command-line tool for managing custom commands in Claude Code. Install and share commands from Git repositories with the ease of a package manager.",
+  "main": "index.js",
+  "scripts": {
+    "postinstall": "node postinstall.js install",
+    "preuninstall": "node postinstall.js uninstall"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gifflet/ccmd.git"
+  },
+  "author": "gifflet",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/gifflet/ccmd/issues"
+  },
+  "homepage": "https://github.com/gifflet/ccmd#readme",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "command-manager",
+    "cli",
+    "package-manager"
+  ],
+  "bin": {
+    "ccmd": "./index.js"
+  },
+  "goBinary": {
+    "name": "ccmd",
+    "path": "./bin"
+  },
+  "files": [
+    "dist",
+    "postinstall.js",
+    "index.js"
+  ],
+  "dependencies": {
+    "mkdirp": "^1.0.4"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/postinstall.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+
+"use strict";
+// Thanks to author of https://github.com/sanathkr/go-npm, we were able to modify his code to work with private packages
+var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; };
+
+var path = require('path'),
+    mkdirp = require('mkdirp'),
+    fs = require('fs');
+
+// Mapping from Node's `process.arch` to Golang's `$GOARCH`
+var ARCH_MAPPING = {
+    "ia32": "386",
+    "x64": "amd64",
+    "arm": "arm",
+    "arm64": "arm64"
+};
+
+// Mapping between Node's `process.platform` to Golang's
+var PLATFORM_MAPPING = {
+    "darwin": "darwin",
+    "linux": "linux",
+    "win32": "windows",
+    "freebsd": "freebsd"
+};
+
+async function getInstallationPath() {
+
+    // `npm bin` will output the path where binary files should be installed
+
+    const value = null //await execShellCommand("npm bin -g");
+
+
+    var dir = null;
+    if (!value || value.length === 0) {
+
+        // We couldn't infer path from `npm bin`. Let's try to get it from
+        // Environment variables set by NPM when it runs.
+        // npm_config_prefix points to NPM's installation directory where `bin` folder is available
+        // Ex: /Users/foo/.nvm/versions/node/v4.3.0
+        var env = process.env;
+        if (env && env.npm_config_prefix) {
+            dir = path.join(env.npm_config_prefix, "bin");
+        }
+    } else {
+        dir = value.trim();
+    }
+    //throw (dir)
+    ///Users/danielpaulus/.nvm/versions/node/v19.7.0/lib/node_modules/go-ios/node_modules/.bin
+    await mkdirp(dir);
+    return dir;
+}
+
+async function verifyAndPlaceBinary(binName, binPath, callback) {
+    if (!fs.existsSync(path.join(binPath, binName))) return callback('Downloaded binary does not contain the binary specified in configuration - ' + binName);
+
+    // Get installation path for executables under node
+    const installationPath = await getInstallationPath();
+    // Copy the executable to the path
+    fs.rename(path.join(binPath, binName), path.join(installationPath, binName), (err) => {
+        if (!err) {
+            console.info("Installed cli successfully");
+            callback(null);
+        } else {
+            callback(err);
+        }
+    });
+}
+
+function validateConfiguration(packageJson) {
+
+    if (!packageJson.version) {
+        return "'version' property must be specified";
+    }
+
+    if (!packageJson.goBinary || _typeof(packageJson.goBinary) !== "object") {
+        return "'goBinary' property must be defined and be an object";
+    }
+
+    if (!packageJson.goBinary.name) {
+        return "'name' property is necessary";
+    }
+
+    if (!packageJson.goBinary.path) {
+        return "'path' property is necessary";
+    }
+}
+
+function parsePackageJson() {
+    if (process.arch !== "arm64" && process.platform !== "darwin") {
+        if (!(process.arch in ARCH_MAPPING)) {
+            console.error("Installation is not supported for this architecture: " + process.arch);
+            return;
+        }
+    }
+
+    if (!(process.platform in PLATFORM_MAPPING)) {
+        console.error("Installation is not supported for this platform: " + process.platform);
+        return;
+    }
+
+    var packageJsonPath = path.join(".", "package.json");
+    if (!fs.existsSync(packageJsonPath)) {
+        console.error("Unable to find package.json. " + "Please run this script at root of the package you want to be installed");
+        return;
+    }
+
+    var packageJson = JSON.parse(fs.readFileSync(packageJsonPath));
+    var error = validateConfiguration(packageJson);
+    if (error && error.length > 0) {
+        console.error("Invalid package.json: " + error);
+        return;
+    }
+
+    // We have validated the config. It exists in all its glory
+    var binName = packageJson.goBinary.name;
+    var binPath = packageJson.goBinary.path;
+    var version = packageJson.version;
+    if (version[0] === 'v') version = version.substr(1); // strip the 'v' if necessary v0.0.1 => 0.0.1
+
+    // Binary name on Windows has .exe suffix
+    if (process.platform === "win32") {
+        binName += ".exe";
+    }
+
+
+    return {
+        binName: binName,
+        binPath: binPath,
+        version: version
+    };
+}
+
+/**
+ * Reads the configuration from application's package.json,
+ * validates properties, copied the binary from the package and stores at
+ * ./bin in the package's root. NPM already has support to install binary files
+ * specific locations when invoked with "npm install -g"
+ *
+ *  See: https://docs.npmjs.com/files/package.json#bin
+ */
+var INVALID_INPUT = "Invalid inputs";
+async function install(callback) {
+
+    var opts = parsePackageJson();
+    if (!opts) return callback(INVALID_INPUT);
+    mkdirp.sync(opts.binPath);
+    console.info(`Copying the relevant binary for your platform ${process.platform}`);
+    let src = `./dist/ccmd-${PLATFORM_MAPPING[process.platform]}-${ARCH_MAPPING[process.arch]}_${PLATFORM_MAPPING[process.platform]}_${ARCH_MAPPING[process.arch]}/${opts.binName}`;
+    
+    if (process.arch === "ia32" && process.platform === "win32") {
+        src = `./dist/ccmd-${PLATFORM_MAPPING[process.platform]}-amd64_${PLATFORM_MAPPING[process.platform]}_amd64/${opts.binName}`;
+    }
+
+    if (PLATFORM_MAPPING[process.platform] === "windows") {
+        let cmd = `copy ${src} ${opts.binPath}/${opts.binName}`
+        cmd = cmd.replace(/\//g, "\\")
+        await execShellCommand(cmd);
+    } else {
+        await execShellCommand(`cp ${src} ${opts.binPath}/${opts.binName}`);
+    }
+
+    await verifyAndPlaceBinary(opts.binName, opts.binPath, callback);
+    console.log("\x1b[32m", "ccmd installed, run 'ccmd --help' for details\n\n")
+}
+
+async function uninstall(callback) {
+    var opts = parsePackageJson();
+    try {
+        const installationPath = await getInstallationPath();
+        fs.unlink(path.join(installationPath, opts.binName), (err) => {
+            if (err) {
+                return callback(err);
+            }
+        });
+    } catch (ex) {
+        // Ignore errors when deleting the file.
+    }
+    console.info("Uninstalled cli successfully");
+    return callback(null);
+}
+
+// Parse command line arguments and call the right method
+var actions = {
+    "install": install,
+    "uninstall": uninstall
+};
+/**
+ * Executes a shell command and return it as a Promise.
+ * @param cmd {string}
+ * @return {Promise<string>}
+ */
+function execShellCommand(cmd) {
+    const exec = require('child_process').exec;
+    return new Promise((resolve, reject) => {
+        exec(cmd, (error, stdout, stderr) => {
+            if (error) {
+                console.warn(error);
+            }
+            resolve(stdout ? stdout : stderr);
+        });
+    });
+}
+
+var argv = process.argv;
+if (argv && argv.length > 2) {
+    var cmd = process.argv[2];
+    if (!actions[cmd]) {
+        console.log("Invalid command. `install` and `uninstall` are the only supported commands");
+        process.exit(1);
+    }
+
+    actions[cmd](function (err) {
+        if (err) {
+            console.error(err);
+            process.exit(1);
+        } else {
+            process.exit(0);
+        }
+    });
+}