[](https://flakehub.com/flake/tsirysndr/envhub) [](https://flakestry.dev/flake/github/tsirysndr/envhub) [](https://crates.io/crates/envhub) [](https://crates.io/crates/envhub) [](https://github.com/tsirysndr/envhub/actions/workflows/ci.yml) [](https://discord.gg/aTGPE3Myhk) EnvHub is a simple tool to manage dotfiles and packages accross multiple machines. Written in [Rust](https://www.rust-lang.org/), internally it uses [nix](https://nixos.org)/[homebrew](https://brew.sh)/[pkgx](https://pkgx.sh)/[devbox](https://www.jetpack.io/devbox) to manage packages and [home-manager](https://nix-community.github.io/home-manager/)/[stow](https://www.gnu.org/software/stow/) to manage dotfiles.  ## 🚚 Installation Using bash : ```bash curl -sSL https://install.envhub.sh | bash ``` Using [Cargo](https://crates.io) : ```bash cargo install envhub ``` Using [Nix](https://nixos.org) : ```bash nix profile install --experimental-features "nix-command flakes" github:tsirysndr/envhub ``` Compile from source : ```bash git clone https://github.com/tsirysndr/envhub.git cd envhub nix develop --experimental-features "nix-command flakes" cargo install --path crates/cli envhub --help ``` Using [Homebrew](https://brew.sh) : ```bash brew install tsirysndr/tap/envhub ``` Or download the latest release for your platform [here](https://github.com/tsirysndr/envhub/releases). ## 🚀 Quick Start Initialize a new environment : ```sh envhub init ``` It will create a new `envhub.hcl` file and a `dotfiles` directory in the current directory. You can then edit the `envhub.hcl` file to add packages and add dotfiles to the `dotfiles` directory. Enable the environment : ```sh envhub use ``` ## 📚 Example The following example will install the `hello` package, set the `EDITOR` environment variable to `vim`, and copy the `.screenrc` and `gradle.properties` files from the current directory to the home directory. ```hcl # Path: envhub.hcl packages = [ "hello" ] envs { "EDITOR" = "vim" } file ".screenrc" { source = ".screenrc" } file ".gradle/gradle.properties" { content = "org.gradle.daemon=true" } ``` See [demo](demo) and [examples](examples) for a more complete example. ## 🧩 As a Dagger Module Call from the command line: ```bash dagger -m github.com/tsirysndr/daggerverse/envhub call \ use --environment github:tsirysndr/dotfiles-example \ --src . ``` call from a [Fluent CI](https://fluentci.io/) module: ```typescript import { use } from 'jsr:@fx/envhub'; await use( ".", "github:tsirysndr/dotfiles-example" ); ``` ## As a GitHub Action You can use EnvHub as a [GitHub Action](https://github.com/tsirysndr/setup-envhub) to manage your dotfiles and packages in your CI/CD workflow. ```yaml - uses: tsirysndr/setup-envhub@v1 with: version: 'v0.2.18' - run: envhub --help ```