Changelog
All notable changes to HelpMake.
[12.5.0] - 2026-11-15
Added
Task { }block - Run arbitrary shell commands (NPM, Python, Java, etc.) with full incremental caching. SupportsCheck:(input files),Generate:(output files), andDepends:. Uses.timestate files so zero-output tasks (likenpm install) are only run when their inputs change.PkgConfig { }block - Automatically fetch--cflagsand--libsfrom Linux/macOS system packages.--ccache(andCcache: true) - Native support forccache. Speeds up incremental builds by 10x. Gracefully falls back ifccacheisn't installed.--linker=mold|lld(andLinker: mold) - Custom linker support for Linux/macOS. Cuts link times by up to 10x.- Advanced Conditional Tags - You can now chain conditions and check for programs/files:
?git:checks if a program is inPATH.?config.json:checks if a file exists.gcc:/clang:applies flags only for the active compiler.!win: ?mold: Linker: moldallows infinite nesting of conditions.
##Escaping -##defineresolves to#definein the parser, allowing comments to be escaped in shell commands.
Fixed
- Pre/Post build output - The output of
PreBuildandPostBuildcommands is now correctly printed to the console. -b <dir>path resolution - Runninghm -b <dir>now behaves exactly likemake -C, changing the working directory before parsing.- Build cache isolation - Objects and
.buildidare now isolated by config name, so changingOutput:no longer forces a full rebuild. -fuse-ld=flag leaking - Linker flags are now correctly separated and don't end up in the compile step.- Inline blocks swallowing tasks - Fixed a parser bug where
InputFiles { main.cpp }on a single line would consume the next block. CommandFlagsoverridingPkgConfig- Fixed an issue where the version flag was overwriting the flags added bypkg-config.
[12.4.5] - 2026-11-10
Added
- Sanitizer Support - You can now use
--sanitize=address,undefined(or setSanitize: addressinHelpMake.txt). HelpMake automatically appends the correct-fsanitize=...,-fno-omit-frame-pointer, and-gflags for GCC/Clang, and/fsanitize=...for MSVC. - Native Binary Stripping - Added
--stripflag andStrip: trueconfig field. Automatically runsstripon the final binary to dramatically reduce its size for release builds (ignored on MSVC). - Package Block - You can now create
.zipor.tar.gzrelease archives natively without any external tools or PostBuild scripts.- On Windows, it uses native PowerShell (
Compress-Archive). - On Linux/macOS, it uses native
ziportar.
- On Windows, it uses native PowerShell (
- Workspaces (Subsets) - Added
Subset { }block andSubset: <path>field. Allows building monorepos from a single root config by automatically entering subdirectories and runninghm -b.
Fixed
- GNU
ldLinker Ordering on Windows - External dependencies (like Raylib) now correctly wrap their link flags in-Wl,--start-groupand-Wl,--end-group. This prevents system libraries (like-lgdi32or-lwinmm) from being discarded by the linker before the dependency archive is processed. - Linker flags leaking into compile step -
-Land-Wl,flags are now correctly separated out and only passed to the linker, keeping the compile commands clean.
[12.4.4] - 2026-11-08
Added
CC,CXX,CROSS_COMPILEenv vars - auto-detection now honors these before falling back to probing.CXX=clang++ hm -bpicks clang++;CROSS_COMPILE=arm-none-eabi- hm -bpicksarm-none-eabi-g++. ExplicitCompiler:and-C=still win over env vars.- Windows entry points -
autoKindnow recognizesWinMain,wmain, and_tmain, not justmain. Windows GUI projects are no longer silently misclassified asKind: static. - Expanded link-flag table - 20 system-library headers (was 11). Adds SDL2, GLFW, OpenGL, GLEW, gtest, fmt, sqlite3, and expat alongside the existing pthread, math, dl, zlib, curl, and OpenSSL entries.
stripSource()- new string utility inhm/util/strings.hppthat blanks out line comments, block comments, and string/char literals in a single pass while preserving line structure. Used byautoKindandautoLinkFlags.
Fixed
--nofilerespects explicit CLI inputs -hm -b --nofile pro.cppnow compiles onlypro.cpp, even when the working directory contains other C/C++ projects. Previously the CLI input was stored inconfig.inputFilebut notconfig.v_inputFiles, so auto-detection ran anyway and picked the dominant extension from a recursive walk of.- often compiling unrelated projects nested in the same parent directory.--nofileskips the auto-detection chain as documented. Only CLI-provided fields are used.--nofilenow errors out with a clear message if-C=<compiler>or an input file is missing, instead of silently falling back to auto-detection.- Positional CLI args populate
config.v_inputFilesin addition toconfig.inputFile, keeping the two lists in sync.InputFiles { }parsing,expandInputs, and companion-source detection all read the same list of files. autoKindignores comments and string literals - a// int main()line comment, a/* int main() {} */block comment, or astd::string s = "main("literal no longer misleads the executable/static decision.autoKinddetects multi-line signatures -int main\n(int, char**)(signature broken across lines) is now recognized.autoLinkFlagsignores quoted includes and comments -#include "pthread.h"(local file),/* #include <pthread.h> */,#includefoo, and#include_next <...>no longer trigger link-flag injection. Only actual#include <...>lines in real code count.autoOutputskips generic directory names - runninghm -bfrom insidebuild/,out/,dist/,bin/,tmp/,temp/, orsrc/no longer names the binary after the folder. Falls through tomain.*detection ora.out/a.exeas the docs already promised.
[12.4.3] - 2026-11-08
Added
- VS Code Extension - Official syntax highlighting for
HelpMake.txtand.helpmakefiles. Available on the VS Code Marketplace inside the website. - Workspaces (Subsets) - You can now make multi-project builds from a single root
HelpMake.txtusing theSubset { }block orSubset: <path>field. HelpMake will automatically build the config file that's in the subset directory. It supports directories (looking forHelpMake.txtor using zero-config) and specific file paths (using-f). - Output Normalization - HelpMake now respects platform-specific naming conventions for
Output:if you omit the file extension.- Executables automatically get
.exeon Windows and no extension on Linux/macOS. - Static libraries automatically get
libprefix and.aon GCC/Clang/MinGW, and.libon MSVC. - Explicit extensions (like
app.binormath.dll) are left untouched.
- Executables automatically get
Fixed
- Linker flags leaking into compile step - Flags like
-Wl,--start-groupand-Lare now correctly separated and only passed to the linker, not the compiler.
[12.4.2] - 2026-11-07
[12.4.1] - 2026-11-07
Added
- Flag grouping - Short flags can now be combined.
hm -bvdis parsed as-b -v -d. Value flags like-bC=clang++are supported. --flag=valuesyntax - Long boolean flags now explicitly accept values, e.g.,--verbose=trueor--quiet=false.-t/--test- Testing is now a standard flag to match-b/--build.-c/--clean- Cleaning is now a standard flag.
Changed
- Short flag convention - Lowercase short flags are strictly for booleans (
-v,-d,-r), while uppercase short flags are for values (-C,-V,-O,-J). The-rshort flag now meansrebuild(use--runto run the output).
Fixed
Linker dependency ordering -
Depends: libpng, zlibno longer fails if the user writes them in the wrong order. HelpMake now wraps generated link flags in-Wl,--start-groupand-Wl,--end-groupfor GCC/Clang to force the linker to resolve circular dependencies.CLI Inconsistency - Previously, building was a flag (
-b) but testing was a subcommand (test). The CLI is now fully consistent, using flags for all major actions (-b,-t,-c).Config-to-Config dependencies -
Depends:can now reference internalConfig:blocks. HelpMake automatically resolves the build order, detects circular dependencies, and builds the dependencies first.Duplicate Config names - HelpMake now throws a parse error if two configs share the same name.
[12.4.0] - 2026-11-05
Added
- Zero-config builds -
hm -bnow builds a project with noHelpMake.txtat all. Every field is inferred at parse time; user-specified values always win. See Auto-detection. autoLinkFlags- scans#include <...>lines and adds the right link flags automatically:<thread>,<mutex>,<atomic>,<condition_variable>,<pthread.h>→-pthread<cmath>,<math.h>→-lm<dlfcn.h>→-ldl<zlib.h>→-lz/zlib.lib(MSVC)<curl/curl.h>→-lcurl/libcurl.lib(MSVC)<openssl/ssl.h>→-lssl -lcrypto/libssl.lib libcrypto.lib(MSVC)- POSIX-only flags are skipped on MSVC. Existing flags are never duplicated.
autoKind- scans every source for a validmain(declaration (main(),main(int argc, char** argv),main(void),int main (int argc , ...)) with word-boundary checks (rejectsdomain(,mainHelper(,main_loop() and picksKind: executableorKind: staticaccordingly. Falls back toexecutablefor non-C-family projects (Zig, Go, Rust, Python, etc.).autoOutput- infersOutput:from twelve different sources, in priority order:Cargo.toml,go.mod,package.json,pyproject.toml,setup.py,build.zig,meson.build,CMakeLists.txt,pom.xml,build.gradle/build.gradle.kts,*.csproj/*.fsproj/*.vbproj,main.*source file, then the directory name. Falls back toa.out/a.exewith a warning.- Companion source detection - when a source includes
"foo.hpp"andfoo.cppexists anywhere in the tree but isn't inInputFiles { },foo.cppis added automatically. Zero extra cost for projects that already list all sources.
Changed
Info:block formatting - multi-line warnings (Auto-added link flags:,Auto-detected include dirs:,Auto-added companion sources:) sort to the bottom of their category so single-line warnings aren't interleaved; continuation lines align under the warning text instead of flush-left.
Fixed
autoIncludesnever emitted-Iflags - the function detected include directories correctly but only stored them inincludeFiles, never appended-I<dir>toflags. Auto-detected projects failed withfatal error: hm/parser/parser.hpp: No such file or directoryeven though the warning claimed the includes were found. BothflagsandincludeFilesare now populated.autoIncludesover-included header parents - every directory containing a header was added as an include root, producing dozens of useless entries like./include/hm/parserand./include/hm/cli. Recursion now stops at the firstinclude/,inc/,headers/,api/, orpublic/directory found. Header parents remain the fallback only when no named include dir exists.collectFileshad an uninitializedbool haveMain;(UB) and only checkedline.find("main()"), missingmain(int argc, char** argv)andmain(void)- the two most common real-world signatures. Replaced byautoKindwith proper word-boundary scanning.autoIncludeshad a leftover debug print (std::cout << "reachedddddddddddd") on the failure path. Removed.
[12.3.0] - 2026-10-30
Added
- MSVC C++20 modules -
.ixx,.cppm,.mpp, and any file inModules { }now compile as module interface units with/interface /TP. The.ifcgoes tobuild/HelpMake/msvc/modules/(via/ifcOutput), consumers import via/reference <name>=<path>. Works for single modules and cross-imports; partitions are still unsupported (need/internalPartitionand per-partition/reference). - Dependency Locking -
hm --update-lockrecords exact Git revisions for Fetch { } and Dependencies, sources inbuild/HelpMake/dep/lock/HelpMake.lock; build with--frozento use those revisions and fail if the lockfile is missing or incomplete. Archive and local-path dependencies aren’t lockable yet. - HelpMake API -
#include "HelpMake.hppincludes all methods to build specified files/modules using specified flags. - Dry Run -
hm -b --dry-runOutputs all commands whitout executing them.
Fixed
- Clang/MSVC self-reference in module flags - the module currently being compiled was getting
-fmodule-file=(Clang) or/reference(MSVC) pointing at its own.pcm/.ifcbefore that file existed. Both compilers tolerate it, but it's fragile. Now skipped whenmodName == current module's name.
[12.2.0] - 2026-10-24
Added
hm test- build and run every config marked withTest: true- Prints pass/fail per test with timing, aggregates the result, exit code 1 on any failure (CI-ready)
--verbose/--debugshow per-file compile output for each test;--quietshows only the summary- Test binaries are actually executed (a config that builds but returns non-zero reports FAIL)
Test: truefield - marks a config as a test target. Valid only insideConfig: { }blocks- Response files - link commands longer than 30,000 characters (Windows caps at 32,767) now write args to
build/HelpMake/<comp>/<baseName>.rspand pass@file.rsp. Fixes silent argument truncation on 300+ file projects --verboseon clean commands -hm --clean --verboseprints each removed path
Changed
hm --clean-alldeletesbuild/HelpMake/andgcm.cache/, not all ofbuild/. User-placed files underbuild/(assets, configs) are preserved- Clean commands return exit code - a failed clean exits 1 with a per-path error, instead of printing "Cleaned X" and exiting 0
Fetch { }is now idempotent - clones only if the target directory doesn't exist. Failed clones clean up so retry works. Missing-> subdirpaths abort at parse timehm testoutput - aligned columns, green/red status, reason column (build failedvsexit code N), failure log paths at the bottom
Fixed
- Clang modules: extension-independent support -
.ixx,.mpp,.module, and any file inModules { }now compile correctly (was failing on.cppm-only paths) - Clang modules:
-fmodulesno longer applied - that flag is Apple Clang's module system, not C++20 modules. Now GCC-only. Fixes MSVC-header compile errors on Clang - Clang modules:
.pcmhandling - emitted tobuild/HelpMake/<comp>/modules/, forces rebuild when missing, compiles sequentially before consumers to prevent parallel races .buildidnow tracks effective compiler command - fixes "Build flags changed" appearing on every build after addingModules { }- Per-config logs use the config's output name -
hm -b --config foowrites tologs/foo.txt, notlogs/hmm.txt.See Logs: Xnow points at the right file hm --cleanhandles read-only files -git clonemarks.git/objects/pack/*read-only; Windows refuses to delete them. Clean commands clear the read-only bit, skip locked subdirectories, and report per-path failures instead of crashing-I/-Lcorrect on MSVC - include and library paths now use/Iand/LIBPATH:instead of the GCC flags--runhandles output paths with spaces - output binary is quoted in the&&chaincompile_commands.jsoncorrect for all Clang module extensions --xc++-moduleemitted for.ixxand.mpp, not just.cpp
[12.1.0] - 2026-10-23
Added
- Platform conditionals - prefix any line with
win:,linux:,mac:,unix:,x64:,arm64:,x86:, or!<tag>to include it only on matching platforms- Works for scalar fields (
win: Output: build/app.exe), block entries (linux: -pthread), andSet { }variables - Recognized:
win/windows,linux,mac/darwin/macos/osx,unix,x64/x86_64/amd64,arm64/aarch64,x86/i386/i686; negation via!tag
- Works for scalar fields (
--watch- rebuild automatically on source, header, orHelpMake.txtchange. Combine with-rfor the full dev loop. Alias:hm --watch≡hm -b --watch- CMake generator: Fetch / Modules / PreBuild / PostBuild / Copy - the generator now emits
FetchContent_*,FILE_SET CXX_MODULES, custom targets, andPOST_BUILDcopy commands. Closes the CMake-vs-Ninja feature gap Set { }scoping per config - aSet { }inside aConfig: { }no longer leaks to other configs
Changed
--verboseoutput cleaned up - config fields print as a compact aligned block per config, not a flat stream ofX found in config 'Y'lines- Generator warnings route through the
Info:block at the end of the build instead of printing mid-parse
Fixed
--genpaths runresolveDependenciesfirst - fetched and dependency include paths are emitted correctly into generated CMake/Ninja/JSON files- Platform conditional overrides work -
win: Output: ...after a fallbackOutput: ...now overrides; previously the first write won and the conditional was silently dropped Set { }uses the config's variable scope - fixes values leaking across configs during parse
[12.0.0] - 2026-10-23
Added
--watch- rebuild automatically when any source, header, orHelpMake.txtchanges- Polls mtimes every 300ms; rebuilds on any detected difference
- Watches
InputFiles(globs expanded), allIncludes { }directories recursively, andHelpMake.txtitself - Works with
--configand--config-all - Top-level alias:
hm --watchis equivalent tohm -b --watch
Changed
- Exit codes now propagate correctly.
hm -breturns non-zero on any failure (parse, compile, link, copy). Previously every path returned 0 - scripts usingif hm -b; then …; fisilently passed on failed builds. This is the intended behavior per the CLI docs, but if you relied on the old always-zero behavior (e.g. ignoring compile failures in CI), adjust your scripts. -f<file>(joined, no space) is now rejected. Use-f <file>or-f=<file>. This fixes a collision where-fsanitize=address,-fno-omit-frame-pointer, and every other-f*compiler flag was silently treated as a build-file path.
Fixed
compile_commands.jsonwas corrupted - every file began with the literal stringcompile_commands.jsonbecause the generator passed that string as the initial content of astd::ostringstream. Now valid JSON.- Parallel builds wrote to a single log file - every job shared
<baseName>.raw, so under-j Nthe compiler failed with "The process cannot access the file because it is being used by another process." Each job now writes to its own log. - Nested source directories failed to compile - object subdirectories (e.g.
obj/src/toolchain/) were not created before invoking the compiler, so-MMDfailed with "opening dependency file: No such file or directory." Fixed. Copy { }with a glob pattern always failed because the code inspected the parent path of the wholesrc -> deststring. Fixed to use the source side only.-I<path>and-L<path>concatenated with the previous flag whenflagswas non-empty butv_Flagswas empty (-Wall+-Iinclude→-Wall-Iinclude). Fixed.- MSVC
Version:got a-prefix -/std:c++20became-/std:c++20. Fixed to preserve/. - CLI prefix matches were too loose -
--varmatched--variant=,--config-allmatched--config-all-xyz, and--Kind=rejected single-character kinds. All tightened. --config-allexecuted each config mid-parse, inheriting a root config that wasn't finished yet. Now runs after all sections are parsed.--runwith spaces in the output path produced./my app.exeunquoted and failed. Fixed.GenericCompiler::directBuildArgsreturned an empty vector, sohm --nofile -C=<unknown>emitted commands with no inputs and no output. Fixed.init.cppalways printedtruefor thecompile_commands.jsonprompt due to<<binding tighter than?:. Fixed.logs/directory was not created for root builds, soSee Logs: build/HelpMake/gcc/logs/<name>.txtpointed at a nonexistent file.- PCH was not invalidated when flags changed -
.buildidtrashedobj/but leftheaders/<compiler>/intact, producing stale precompiled headers after-DDEBUGtoggles. v_DepFilesaccumulated across configs, so a header touched by one config forced the PCH to rebuild in every subsequent config.- Ninja generator collided on identical stems -
src/foo.cppandfoo.cppboth producedfoo.o. Now uses full relative paths. Parser::executeConfigreadcfg.debugandcfg.v_Infoinstead of the per-configc.debug/c.v_Info, soArguments: debuginside aConfig: { }block was silently ignored, andGen { }info lines for configs never printed.Arguments: verbose debugwas passed as one token toparseArgument, so multi-wordArguments:lines were dropped. Now split.- MSVC got GCC flags in
compile_commands.json--fdiagnostics-color=always,-c,-o,-MMD. Now emits/nologo /c /Fo:. -Cand-Vbare forms (-C gcc,-V std=c++20) were rejected; only-C=/-V=worked. Both accepted now.Fetch { }shelled out togit cloneeven during--checkand--show, doing network I/O when the user only wanted to validate the file. Now skipped in--check.extractModulecalledstd::exit(1)on files withoutexport module, terminating the build instead of reporting an error. Now returns an empty string.parseVarbroke out of the parsing loop on the first undefined variable, leaving the rest of the line unparsed. Now continues and still reports all errors.Set { }variables leaked across configs - a[[x]]in config B could resolve to a value set in config A depending on section order. Now scoped per config.
[11.2.0] - 2026-10-21
Added
hm --gen cmake- emitCMakeLists.txtfor the selected confighm --gen json/hm --gen compile_commands- emitcompile_commands.json(previously only via--json)--gen <name> --config <name>- generate build files for a specific config, not just the root
Fixed
--gen jsonnow respects--config(previously generated for the root config)
Known issues
LinkFlags:order relative to archive paths may need adjustment for static libraries with unresolved system symbol dependenciesDependency:blocks must appear before anyConfig:blockDepends:between dependencies (transitive ordering) is parsed but not yet executed
[11.1.0] - 2026-10-21
Added
Dependency: name { }blocks - fetch, build, and link external librariesGit:,Url:,Path:sourcesTag:,Commit:,Hash:version pinningBuild:shell command list (repeatable) with.buildidcacheInclude:,Link:,LinkDir:,LinkFlags:integration- Cache lives at
build/HelpMake/dep/<name>/
Depends:field on configs - pulls dependency blocks into a build- Go toolchain (
go build) with-GoCLI flag hm --gen ninja- emit abuild.ninjafilehm --genwith no argument lists available generators
Changed
- GCC/Clang now select
gcc/clangfor.csources and add-xc(previously all sources were forced into C++ mode viag++ -xc++) executeConfigtreats.a,.lib, and.sopath arguments as link inputsParser::parse()refactored into a section splitter plus a per-section parser
Fixed
- CLI flags (
-o,-C=,-V=,--Kind=,--var) now correctly override values inHelpMake.txt- previously the file value always won - Interrupted builds no longer leave stale objects that produce confusing "undefined reference" errors on the next build (still requires
hm --cleanafter a hard interrupt, but the failure is now obvious)
Known issues
LinkFlags:order relative to archive paths may need adjustment for static libraries with unresolved system symbol dependencies (GNUldprocesses left-to-right)Dependency:blocks must appear before anyConfig:block inHelpMake.txtDepends:between dependencies (transitive ordering) is parsed but not yet executed- Dependency cache assumes a clone succeeded; corrupt clones from interrupted
git cloneneed a manualrm -rf build/HelpMake/dep/<name>
[11.0.0] - 2026-18-10
Added
- MSVC, Zig, Zig C++, Zig CC toolchains
- Precompiled headers (all toolchains)
Set { }variables and--varCLI overrideCopy { }block
Changed
- Objects now live under
build/HelpMake/<compiler>/obj/ - Changing compiler or flags forces a clean rebuild
Fixed
- Worker threads no longer abort chunks on first failure
- Per-file logs land in per-compiler log dirs
[10.x] - earlier
Added
- Zig support (build-exe)
--jobsparallel compilation- C++20 modules (GCC + Clang)
[9.x] - earlier
Added
- Static libraries (
Kind: static) --initinteractive wizard--installautomatic setup
[8.x] - earlier
Added
Config: name { }blocks--jsoncompile_commands.json generation--createfrom CLI args
[7.x] - earlier
Added
--quiet,--notify,--clean-gcm- Header tracking (incremental via
.d)
[6.x] - earlier
Added
- C++20 modules (first version)
-C=<compiler>and-V=<version>any-compiler support
[5.x] - earlier
Added
Fetch { }git cloning- PreBuild / PostBuild hooks
[4.x] - earlier
Added
Includes { },Flags { }blocks--run,--debug,--verbose
[3.x] - earlier
Added
- Zig support (first pass)
- GitHub link fetching
[2.0.0] -
Added
Flags { }block, inline forms- Version tracking
[1.x] -
Added
- Initial release:
Compiler:,Version:,Output:,InputFiles:
