46 lines
1.4 KiB
Markdown
46 lines
1.4 KiB
Markdown
# bootstrap_dev_env
|
|
|
|
A Go-based bootstrap tool that installs a development environment across
|
|
macOS, Debian/Ubuntu, RHEL/Fedora, and Arch Linux on `x86_64` and `aarch64`.
|
|
It installs system packages, optional Flatpak GUI apps, and a set of custom
|
|
third-party tools (Go, Neovim, Zig, NVM, pyenv, oh-my-zsh, Firecracker on
|
|
Linux, agy, claude, codex, and copilot).
|
|
|
|
## Install
|
|
|
|
Download the native binary for your platform from a release, or build from
|
|
source:
|
|
|
|
```shell
|
|
git clone https://github.com/JMR-dev/bootstrap_dev_env.git
|
|
cd bootstrap_dev_env
|
|
make build # builds ./bootstrap_environment for the host
|
|
```
|
|
|
|
To produce native binaries for all four supported targets at once:
|
|
|
|
```shell
|
|
make build-all # writes dist/bootstrap_environment-{linux,darwin}-{amd64,arm64}
|
|
```
|
|
|
|
## Usage
|
|
|
|
```shell
|
|
# Linux (do NOT use sudo on macOS — Homebrew refuses to run as root)
|
|
sudo ./bootstrap_environment [--only system|flatpak|custom] [--gui]
|
|
|
|
# macOS
|
|
./bootstrap_environment [--only system|custom] [--gui] [--no-vm]
|
|
```
|
|
|
|
Flags:
|
|
|
|
- `--only` — restrict to one section (`system`, `flatpak`, or `custom`).
|
|
- `--gui` — include GUI applications and the Flatpak section. Default is
|
|
headless: both are skipped.
|
|
- `--no-vm` — macOS only: skip provisioning the Fedora-on-QEMU/VirtualBox VM
|
|
that backs the `firecracker()` zsh wrapper.
|
|
- `--no-ai` — skip installation of AI/LLM CLI tools (agy, claude, codex, copilot).
|
|
|
|
Package lists live in `packages.go`. Edit and rebuild.
|