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

# 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)

npm install -g @hdwebsoft/hdkit

Or use with npx (no global install needed):

npx @hdwebsoft/hdkit <command>

Install from source

# Clone the repository
git clone [email protected]: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.

hdkit versions

hdkit skills

Inspect skills available in a release.

# 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.

# 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.

# 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:

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

License

MIT