A build tool for your Linux distro. Clone, pull, pick a target, build — all from one command.
Automatically clones a fresh repo on first run. On subsequent runs it does a git pull instead — no manual setup.
Reads your Makefile and presents an arrow-key driven TUI to select the build target. Pass --target to skip it.
Every run writes a log to ~/.local/log/gbuild/ named with a timestamp and project name. Never lose build output.
Built-in TUI log browser with live preview pane. Navigate, open in less, or delete old logs — all from the terminal.
Git URL, username, and credentials live in ~/.gconfig. Runtime flags --url and --user override the config when needed.
Pure bash. Requires only git, make, and less — tools already on every Linux build server.
gbuild reads its Git server URL, credentials, and defaults from ~/.gconfig —
an INI-style config file managed by the companion gconfig tool.
No more hardcoded values or repeated flags.
| command | description |
|---|---|
| gconfig init | Create ~/.gconfig with defaults if it doesn't exist |
| gconfig init --force | Overwrite config, backing up the old file first |
| gconfig show | Print current config values (auth fields masked) |
| gconfig help | Print usage information |
| flag | value | description |
|---|---|---|
| --url | <url> | Override the Gitea base URL. default: value from ~/.gconfig |
| --user | <name> | Override the Gitea username. default: value from ~/.gconfig |
| --target | <target> | Run a specific make target, skipping the interactive picker. default: interactive |
| --logs | Open the interactive log browser (TUI). | |
| -h, --help | Print usage and exit. |
Manages ~/.gconfig — required for gbuild to know your Git server and credentials.