ahk64

A lightweight AutoHotkey 64-bit toolchain for Windows. This package bundles the official AutoHotkey runtime, compiler, and mpress packer so you can run or compile AHK scripts inside a Node.js build pipeline (e.g. from npm scripts, CI/CD jobs, or other automation).

✨ Features

• Run .ahk scripts via the 64-bit AutoHotkey interpreter.
• Compile .ahk scripts into standalone .exe files using Ahk2Exe.
• Works seamlessly inside npm/yarn/pnpm scripts—no separate installer needed.

📦 Installation

npm install --save-dev ahk64

Only Windows x64 is supported ("os": ["win32"], "cpu": ["x64"]).

🚀 Usage in package.json scripts

Example package.json:

{
  "scripts": {
    "run:ahk": "ahk64 run src/my-script.ahk",
    "build:ahk": "ahk64 compile src/my-script.ahk /out dist/my-script.exe"
  }
}

Run from the command line:

npm run run:ahk
npm run build:ahk

or directly with npx:

npx ahk64 compile src/my-script.ahk

🛠 CLI Syntax

ahk64 <command> [args...]

Commands

| Command | Underlying binary | Typical use | | --------- | ----------------------- | ------------------------------------------------------------------------------------------------- | | run | AutoHotkey64.exe | Run a .ahk script. | | compile | Ahk2Exe.exe | Compile a .ahk script to .exe. Automatically sets /base to the included AutoHotkey64.exe. |

All remaining arguments are passed straight to the underlying tool.

Examples

# Compile with custom output path
npx ahk64 compile src/hotkeys.ahk /out dist/hotkeys.exe

# Run a script directly
npx ahk64 run src/hotkeys.ahk

# Compress an existing exe
npx ahk64 mpress dist/hotkeys.exe

📁 Included Binaries

The package ships these files inside bin/:

• AutoHotkey64.exe
• Ahk2Exe.exe
• mpress.exe

⚠ Notes

• The package is intended for automated build scripts, not for interactive editing.
• Requires Node.js 16+ (ESM support).
• Windows x64 only.

📜 License

This npm package is distributed under the GPL-2.0 license. AutoHotkey binaries are redistributed under their respective licenses.

Repository: https://github.com/Nigh/AHK-npm

Tip: If you commit your package-lock.json or pnpm-lock.yaml, your CI builds will always use the exact same AutoHotkey binaries for reproducible results.