npm package: @nockdev/cli
Description: NOCK CLI - Extensible Development Platform by NockDev
Author: NockDev
Latest version: 1.1.8

<p align="center">
  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:0F172A,50:1E40AF,100:6D28D9&height=160&section=header&text=NOCK%20CLI&fontSize=42&fontColor=FFFFFF&animation=fadeIn&fontAlignY=35&desc=Extensible%20AI%20Development%20Platform&descAlignY=55&descSize=16" width="100%" />
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/@nockdev/cli"><img src="https://img.shields.io/npm/v/@nockdev/cli?style=for-the-badge&logo=npm&logoColor=white&labelColor=CB3837&color=000000" alt="npm" /></a>
  <img src="https://img.shields.io/badge/node-%E2%89%A518.0.0-10B981?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js" />
  <img src="https://img.shields.io/badge/license-MIT-3B82F6?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="License" />
</p>

<p align="center">
  <b>Microkernel CLI</b> with auto-discovery plugins. Install once, extend with official and community packages.
</p>

---

## ⚡ Quick Start

```bash
npm install -g @nockdev/cli    # Install globally
nock setup                     # One-command zero-config setup
```

> 💡 `nock setup` auto-installs the AWF plugin and runs `init --yes` — no prompts needed.

Or step by step:

```bash
nock awf init                  # Interactive initialization wizard
nock awf install               # Install IDE configurations
```

---

## 🎯 Core Commands

| Command                  | Description                                    |
| :----------------------- | :--------------------------------------------- |
| `nock setup`             | One-command zero-config setup (auto-install)    |
| `nock --help`            | Show help and available commands                |
| `nock version`           | Show CLI and plugin versions                    |
| `nock version --json`    | Machine-readable JSON output (for CI/scripts)   |
| `nock upgrade`           | Self-upgrade CLI to latest version              |
| `nock plugins list`      | List installed plugins                          |
| `nock plugins install`   | Install a plugin from npm                       |
| `nock plugins remove`    | Remove an installed plugin                      |
| `nock plugins update`    | Update plugin(s) to latest                      |
| `nock telemetry`         | Manage anonymous usage data                     |
| `nock cache`             | View/clear manifest cache                       |

### Per-Command Help

Every command supports `--help` for detailed flag documentation:

```bash
nock awf install --help    # Show all flags, aliases, defaults, choices
nock awf init --help       # Show init flags including --yes
```

### Fuzzy Suggestions

Mistype a command? NOCK suggests the closest match:

```
$ nock setip
✖ Unknown command: setip
  Did you mean: nock setup?
```

---

## 🔌 Plugin System

NOCK CLI uses a **microkernel architecture** — the core is lightweight (~18 files), plugins provide all functionality.

```
$ nock awf init
⚡ Plugin 'awf' is not installed.
◆ Would you like to install @nockdev/awf?
📦 Installing @nockdev/awf...
✔ Installed @nockdev/awf@6.4.13
```

### Official Plugins

| Plugin                                                       | Description                                                                 |
| :----------------------------------------------------------- | :-------------------------------------------------------------------------- |
| [`@nockdev/awf`](https://www.npmjs.com/package/@nockdev/awf) | 🧠 AI development assistant — 88 skills, 26 IDEs, 41 workflows, 11 personas |
| [`@nockdev/hsa`](https://www.npmjs.com/package/@nockdev/hsa) | 🔍 HSA MCP Server — 15 tools, BM25+ search, Doc Fetcher, LiveCanvas, dashboard |

### Plugin Management

```bash
nock plugins list               # List installed plugins
nock plugins install <package>  # Install a plugin
nock plugins remove <package>   # Remove a plugin
nock plugins update [package]   # Update plugin(s)
nock plugins link <path>        # Link local plugin (dev)
nock plugins unlink <path>      # Unlink local plugin
```

---

## 🧠 AWF Plugin Commands

| Command                          | Description                          | Aliases      |
| :------------------------------- | :----------------------------------- | :----------- |
| `nock awf init`                  | Initialize DOMYH in your project     | `i`          |
| `nock awf install`               | Install IDE configurations           | `ins`        |
| `nock awf list`                  | List available skills and workflows  | `ls`, `l`    |
| `nock awf doctor`                | Diagnose IDE configurations          | `diag`       |
| `nock awf info`                  | Show detected stack and project info | `status`     |
| `nock awf config`                | Manage configuration                 | `cfg`, `c`   |
| `nock awf update --check`        | Check for CLI updates                | `up`         |
| `nock awf hsa`                   | Manage HSA context engine            | `context`    |
| `nock awf mcp`                   | Configure MCP server for IDEs        |              |

### Key Flags

```bash
nock awf init --yes              # Zero-config: skip all prompts
nock awf init --language vi      # Set language (en/vi)
nock awf install --ide cursor    # Install for specific IDE
nock awf install --profile full  # Full install (all modules + tier2 files)
nock awf install --force         # Overwrite existing configs
nock awf install --dryRun        # Preview without writing
```

---

## 📦 Install Flow

```
  ╔══════════════════════════════════════════╗
  ║   ◆ NOCK — Awesome Code Framework       ║
  ║   v6.5.0 · Install Configuration        ║
  ╚══════════════════════════════════════════╝

  [1/5] Language
  [2/5] Select IDE(s)
  [3/5] Choose scope
  [4/5] Select profile
  [5/5] Installing...

  ╭──────────────────────────────────────────────╮
  │  ◆ Installation Complete                      │
  │  IDEs       3 configured                       │
  │  Profile    standard                            │
  │  Scope      2 project, 1 global                 │
  ╰──────────────────────────────────────────────╯
```

---

## 🛠️ Build Your Own Plugin

```typescript
import type { NockPlugin } from "@nockdev/cli";

const myPlugin: NockPlugin = {
  name: "@my/plugin",
  version: "1.0.0",
  topic: "my",
  description: "My awesome plugin",
  commands: [
    {
      name: "hello",
      id: "my:hello",
      description: "Say hello",
      run: async () => console.log("Hello from my plugin!"),
    },
  ],
};

export default myPlugin;
```

---

## 📋 Requirements

- **Node.js** ≥ 18.0.0
- **npm** ≥ 8.0.0

## 📄 License

MIT © [**NockDev**](https://github.com/nockasdd)

<p align="center">
  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:6D28D9,50:1E40AF,100:0F172A&height=100&section=footer" width="100%" />
</p>