Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ahk64) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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.