No user-facing changes in this release.

• Update internal dependencies
• Update readme to use CommonMark syntax RE the maintenance mode announcement
• Hide the "above-the-fold" debug GIF by default to reduce auto-playing, unpausable animations

No user-facing changes in this release, but there may be minor performance improvements due to internal dependency upgrades.

• Update internal dependencies
• Cleanup readme

Reminder: AHK++ will go into maintenance mode on January 1, 2027. Critical bugs and security issues will still be addressed, but no new features will be added. See the announcement for more details.

• Make "Configuration changed" log debug-level instead of info-level (#625 (comment))
• Remove "Invalid setting" log if logLevel setting was not found (#644)
• Fix excessive logs when #include files aren't found by AHK++ (#641, #646, #649, and #657)
  • Logic to detect these files has improved but still has at least one known issue: #628
  • When a file isn't found, the log is now debug level instead of warn level to reduce noise
• Improve AHK v1 snippet for CoordMode (PR #651)

• Add AHK++ > General > logLevel for logs in output channels (#625, #635)

All changes in 6.6.0 are exclusive to AHK v1.

• Improve extension performance when loading AHK v1 scripts (PR #615)
• Change Method to Function in document symbols and internal references. This changes the document outline slightly, but should not change most theme icons and is more correct. (PR #620)
• Have scripts referenced by #include bypass the exclude setting (PR #623)
• Add experimental funcDefSearch setting that improves function definition resolution. For known issues, see settings.md. (PR #623)

Debugger

• Add docs/debugging.md and docs/_welcome.md
• Fix .vscode/launch.json support for AHK v1 (Issue #603)
• Add .vscode/launch.json support for AHK v2 (Issue #603)
• Change "AutoHotkey execute bin not found: ..." to "AutoHotkey interpreter not found" with a preceding message showing the interpreter path. (PR #606)
• Remove the runtime argument from launch.json for both AHK v1 and AHK v2 due to issues with cross-version debugging (PR #606)
  • We are not considering this a breaking change as this behavior didn't work before. If you'd like to use different AHK interpreters across different workspaces, use IDE workspace settings. If you'd like to use different AHK interpreters within a single workspace, please open a discussion and we'll be happy to help.

IntelliSense

• Add detailed __New docs for InputHook and basic __New docs for all Object descendants that didn't have it (Issue #586)

• Fix IniWrite IntelliSense (#590)
• Add comprehensive settings reference in Markdown and improve docs within the settings editor (#581)
• Update internal dependencies to Node 22, npm 11, and Mocha 11 to improve developer security and developer experience (#583)

• Reduce required VS Code version to 1.68 (#574)
• Update internal dependencies for security (#577)

Known issues

• If your AHK v2 interpreter is not recognized and you try to debug an AHK v2 script, an "AutoHotkey execute bin not found: ..." output log will appear and take focus in the AHK++ (v1) output channel (open issue #570)
• The "Select AHK v2 interpreter" command does not work, instead please try to run (not debug) an AHK v2 script and use the quick pick from the "... does not exist" error message (open issue #571)

Fixes

• Add troubleshooting guide
• Fix go to definition in AHK v1 files (#559)
• Remove unnecessary error message "Couldn't resolve AHK v2 interpreter" (#493)
  • This has been moved to a output log visible in the AHK++ (v2) output channel
  • A "... does not exist" error message will still appear when trying to run an AHK v2 script with an unrecognized interpreter path
• Fix quick pick for "... does not exist" error message on run AHK v2 script (PR #569)

  Note: this fix copies your config into your workspace settings. If you don't like this, please manually enter the path via the settings, and don't use the quick pick. Learn more at PR #569.

New features

• Hovering over a filename in an #include directive now provides a link to that document in your IDE
  • If the file doesn't exist, the underline doesn't appear
  • Does not work for #include <lib> syntax yet.

Bugfixes

• Update thqby's extension from 2.5.3 to 2.5.4, adding new bugfixes
  • Improve "go to definition" in v2 files (thqby #610)
  • Improve environment variables when debugging via IDE for parity with running outside of IDE (thqby #615)
  • Add hover tip for switch keyword in v2 files (thqby #623)