Zero config
Detects compiler, sources, includes, link flags, and output name automatically.
Point hm -b at any project. It figures out the rest.

Editor Support: Get syntax highlighting for
HelpMake.txtin VS Code. Install the HelpMake extension

Point hm -b at any C/C++ project. No CMakeLists. No Makefile. One command.
HelpMake is a build system for people who think CMake is too much and Make is too little.
No config file? No problem. Drop hm into any project directory and run hm -b. It detects your compiler, standard version, source files, include paths, link flags, target kind, and output name - then builds. Add a HelpMake.txt only when you want to pin a field or override a default.
cd your-existing-project
hm -b # detects everything, buildsWhen you do want control, one file describes the whole build:
Compiler: g++
Version: std=c++20
Output: build/app.exe
InputFiles {
src/**/*.cpp
}
Includes {
include
}
Flags {
-Wall
-O2
linux: -pthread
win: /W4
}hm -b # build
hm -b -w -r # rebuild on save + run after every build
hm -b --dry-run # preview build commands without executing them
hm test # run every config marked Test: trueCMake is 20 years old and carries a lot of weight. HelpMake isn't trying to replace it for 100,000-file projects with 400 dependencies. It's for the 90% of projects that just need:
Dependency: clones and builds them)| HelpMake | CMake | Make | |
|---|---|---|---|
| Zero-config builds | ✅ hm -b just works | ❌ requires CMakeLists.txt | ❌ requires Makefile |
| Learning curve | one file, ~10 keywords | CMakeLists + CMakeLang + generators | Makefile syntax + tab-vs-space archaeology |
| Cross-platform | ✅ built-in platform conditionals | ✅ | ❌ shell-dependent |
| Parallel builds | ✅ -j N by default | ✅ | needs -j + careful deps |
| C++20 modules | ✅ GCC + Clang, verified | ✅ (3.28+) | manual --precompile wiring |
| Precompiled headers | ✅ all toolchains | ✅ | manual |
| Watch mode | ✅ built-in | needs wrapper | needs wrapper |
| Test runner | ✅ built-in | CTest | manual |
| Dependency fetching | ✅ Dependency: { } | FetchContent | manual |
| File size of config | ~15 lines | ~50 lines | ~30 lines |
The tradeoff: HelpMake doesn't do everything CMake does. It won't generate Visual Studio solutions. It won't auto-detect hundreds of system libraries. It's a build system, not a project generator. If you need those things, use CMake.
If you just want hm -b to build your thing on Windows, Linux, and macOS from the same file - or from no file at all - this is for you.
Run hm -b in a directory with no HelpMake.txt and HelpMake:
gcc, clang, cl, g++, clang++, zig c++, zig cc, zig, go, rustc, python3 (based on source extensions) and picks the first one on PATH<compiler> -dumpversion and selects the newest standard it supportssrc/, source/, code/, app/ (or . if none exist), skipping .git/, build/, node_modules/, vendor/, test/, etc.#include "x.hpp" to find x.cpp companions anywhere in the treemain( and picks Kind: executable or Kind: staticinclude/, inc/, headers/, api/, or public/ directories#include <...> for -pthread, -lm, -ldl, -lz, -lcurl, -lssl -lcryptoOutput: from the twelve manifest formats aboveInfo: so you can see exactly what was inferredEvery field can still be pinned explicitly - user-specified values always win.
Compiles C, C++, Zig, Go, Assembly, Rust, or anything with a CLI compiler. Built-in toolchains for the common cases; -C=<command> for everything else.
| GCC | Clang | MSVC | Zig C++ | Zig CC | Zig | Go | |
|---|---|---|---|---|---|---|---|
| Compile | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Static libraries | ✅ | ✅ | ✅ | ✅ | ✅ | - | - |
| Precompiled headers | ✅ | ✅ | ✅ | ✅ | ✅ | - | - |
| C++20 modules | ✅ | ✅ | ✅ | - | - | - | - |
| Response files | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | - |
Config: name { } - multiple targets per file. hm -b --config debug, --config release, --config-all.Dependency: name { } - fetch, build, and link external libraries. Git/URL/local-path sources, tag/commit pinning, shell build scripts. Cache at build/HelpMake/dep/.hm --update-lock records exact Git revisions in HelpMake.lock; use hm -b --frozen to require them.Set { } variables - [[name]] expansion everywhere, --var NAME=VALUE CLI override for CI.win:, linux:, mac:, unix:, x64:, arm64:, !tag: on any line.PCH: field. Works on GCC, Clang, MSVC, Zig C++.Modules { } block. Partition support, .pcm caching.Kind: static. Produces .a / .lib..d files, flag-change invalidation, per-compiler object isolation.-j N, defaults to std::thread::hardware_concurrency().PreBuild { } / PostBuild { } / Copy { } - run scripts before/after the build, stage assets.Fetch { } - quick clone-and-include for header-only libraries.hm -b -w - watch mode. Polls every 300ms, rebuilds on change, watches headers and HelpMake.txt itself.hm test - runs every config with Test: true, aggregates results, exits non-zero on failure.hm -b -r - build and run in one command.--verbose - per-file timings, full command lines.--debug - parser trace, flag resolution, config inheritance.hm -b --json - emits compile_commands.json for clangd / IntelliSense / VS Code C++.hm --gen ninja - emits build.ninja for editors and CI pipelines.hm --gen cmake - emits CMakeLists.txt for upstream consumers.Compilr: → "Did you mean Compiler?"cd your-existing-project
hm -bCompiler: g++
Version: std=c++20
Output: build/app.exe
InputFiles {
src/**/*.cpp
}
Includes {
include
}
Flags {
-Wall -O2
win: /W4
linux: -pthread
mac: -pthread
}hm -b # build
hm -b -w -r # rebuild + rerun on save
hm --clean # delete build cacheCompiler: g++
InputFiles { src/*.cpp }
Config: debug {
Flags: -Wall -g -O0 -DDEBUG
Output: build/app-debug
}
Config: release {
Flags: -Wall -O3 -DNDEBUG
Output: build/app-release
}hm -b --config debug
hm -b --config releaseDependency: raylib {
Git: https://github.com/raysan5/raylib
Tag: 5.5
Build: cmake -B build -DBUILD_EXAMPLES=OFF
Build: cmake --build build
Include: src
Link: build/raylib/libraylib.a
}
Config: app {
Depends: raylib
InputFiles { src/main.c }
}Config: test-core {
Test: true
Output: build/test-core
InputFiles { tests/core.cpp }
}
Config: test-api {
Test: true
Output: build/test-api
InputFiles { tests/api.cpp }
}hm test # builds + runs both, exits 1 on any failurehm -b --jsonFull documentation lives in docs/.
Every field is optional - HelpMake auto-detects it when omitted. See Auto-detection.
Compiler: g++ # auto-detected from source extensions
Version: std=c++20 # auto-detected from compiler -dumpversion
Output: build/app # auto-detected from manifests, main.*, or dir name
Kind: static # auto-detected from presence of main(
Run: true # never auto-detected
PCH: include/pch.hpp # never auto-detected
Jobs: 8 # default: all cores
Test: true # mark as a test target (hm test)
Depends: raylib, lua # comma-separated dependency namesInline forms work too: Flags: -Wall -O2, Includes: include external/glfw.
InputFiles { src/**/*.cpp }
Includes { include external/glfw/include }
Flags { -Wall -O2 }
Modules { math.cppm graphics.ixx }
Fetch { https://github.com/user/repo.git -> include/repo }
Copy { assets -> build/assets }
PreBuild { python3 tools/gen_version.py }
PostBuild { strip build/app }Prefix any line with win:, linux:, mac:, unix:, x64:, arm64:, x86:, or !<tag>::
Flags {
-Wall
win: /W4 /permissive-
linux: -Wextra -fPIC
mac: -Wextra
x64: -march=native
}Run hm --help for the full list, or see docs/03-cli-reference.md.
| Toolchain | Binary | PCH | Modules | Static libs | Response files |
|---|---|---|---|---|---|
| GCC | g++ / gcc | ✅ | ✅ | ✅ | ✅ |
| Clang | clang++ / clang | ✅ | ✅ | ✅ | ✅ |
| MSVC | cl.exe | ✅ | ✅ | ✅ | ✅ |
| Zig C++ | zig c++ | ✅ | - | ✅ | ✅ |
| Zig CC | zig cc | ✅ | - | ✅ | ✅ |
| Zig | zig | - | - | - | ✅ |
| Go | go | - | - | - | - |
| Generic | any | - | - | ✅ | ✅ |
Full toolchain notes: docs/04-toolchains.md.
Bugs, feature requests, and doc improvements are welcome.
If HelpMake saves you time, star the repo - it helps other developers find it.
MIT - see LICENSE.