⚡ Quick Start

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:

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:

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/[email protected]

Official Plugins

| Plugin | Description | | :----------------------------------------------------------- | :-------------------------------------------------------------------------- | | @nockdev/awf | 🧠 AI development assistant — 88 skills, 26 IDEs, 41 workflows, 11 personas | | @nockdev/hsa | 🔍 HSA MCP Server — 15 tools, BM25+ search, Doc Fetcher, LiveCanvas, dashboard |

Plugin Management

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

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

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