open-index/open-npm huggingface dataset:
npm package: @hdwebsoft/hdkit
Description: HDKit CLI - manage ai-workflows releases
Latest version: 0.0.4

# HDKit CLI

HDKit is a CLI tool for managing AI workflow releases from HDWebsoft. It lets you discover, inspect, and interactively install AI skills/workflows from release archives.

## Quick Start

```bash
# Install globally
npm install -g @hdwebsoft/hdkit

# List available releases
hdkit versions

# Install skills interactively
hdkit install
```

## Installation

### Prerequisites

- Node.js 18+
- npm

### Install from npm (recommended)

```bash
npm install -g @hdwebsoft/hdkit
```

Or use with npx (no global install needed):

```bash
npx @hdwebsoft/hdkit <command>
```

### Install from source

```bash
# Clone the repository
git clone git@gitlab.com:hdwebsoft/ai/kit/hdkit-cli.git
cd hdkit-cli

# Install dependencies
npm install

# Build the TypeScript source
npm run build

# Link the CLI globally
npm link
```

## Commands

### `hdkit versions`

List all available releases from the HDWebsoft server.

```bash
hdkit versions
```

### `hdkit skills`

Inspect skills available in a release.

```bash
# List skills from latest release
hdkit skills

# List skills from a specific release
hdkit skills --version ai-workflows-20250101-120000
```

### `hdkit install`

Interactively install AI skills to your local environment.

```bash
# Interactive install (recommended)
hdkit install

# Install with options
hdkit install --version ai-workflows-20250101-120000 --target ~/.claude

# Preview without making changes
hdkit install --dry-run
```

#### Install options

| Option | Description | Default |
|--------|-------------|---------|
| `--version <name>` | Use a specific release version | Latest |
| `--target <dir>` | Target directory for installation | `~/.claude` |
| `--installer <mode>` | Installer mode (`extract`, `claude`, `amp`, or `all`) | `extract` |
| `--dry-run` | Preview what would be installed without making changes | `false` |

### `hdkit mcp`

Manage MCP (Model Context Protocol) servers.

```bash
# Initialize MCP configuration
hdkit mcp init

# Sync MCP servers
hdkit mcp sync
```

## How It Works

1. Fetches available release archives from the HDWebsoft server
2. Downloads the selected zip archive
3. Lists skills available in the archive
4. Extracts selected skills to `<target>/.claude/skills/<skill-name>/`
5. Optionally runs bash installers (`install-claude.sh`, `install-amp.sh`)
6. Saves your preferences to `~/.hdkit/config.json` for future runs

## Configuration

User preferences are stored in `~/.hdkit/config.json`:

```json
{
  "lastVersion": "ai-workflows-20250101-120000",
  "targetDir": "~/.claude",
  "installerMode": "extract",
  "selectedSkills": ["skill-1", "skill-2"]
}
```

## License

MIT