asvoboda/godel

Gödel is a Go project build tool that automates all the routine tasks developers need to do, formatting code, checking for problems, running tests, building executables, and publishing releases. Instead of writing custom scripts or remembering which commands to run, you configure gödel once with a few simple files, and then everyone on your team (and your CI system) can run the same commands consistently. Here's how it works in practice. You add gödel to a project by copying a single script file and a configuration folder into your repository. Then you use commands like ./godelw format to automatically clean up your code style, ./godelw check to run linting tools that catch bugs, ./godelw test to run tests, and ./godelw build to create executables ready to distribute. All the configuration, which files to check, which tests to run, which platforms to build for, lives in a single declarative configuration file instead of being scattered across multiple shell scripts. This means your build process becomes predictable and reproducible: the same commands work the same way whether you're on your local machine or in a CI pipeline. A developer or team lead would use this if they want to stop fiddling with build scripts and make sure their Go projects follow consistent standards. For example, a startup building multiple Go microservices could set up gödel once, then every service automatically gets the same code formatting, linting, and testing rules. A team could also use gödel's integration with Git to automatically format code whenever someone commits, or use ./godelw verify as a single command to check everything is correct before pushing. Gödel also handles more advanced tasks like building releases for different operating systems, creating distribution packages like tarballs or RPMs, and publishing built artifacts to package repositories like Bintray. What makes this project notable is its focus on being lightweight and portable, it adds less than 50 kilobytes to your repository and can be distributed to your team as a few simple files. Rather than requiring a separate build server or tool installation, you just copy the gödel files into your project and check them into version control. This makes onboarding new developers easier since they don't need to install anything special to build the project correctly.