Installation¶
macOS and Linux (recommended)¶
curl -fsSL https://raw.githubusercontent.com/johnstegeman/haven/main/install.sh | sh
The installer:
- Detects your OS and CPU architecture
- Downloads the matching binary from the latest GitHub release
- Verifies the SHA256 checksum
- Installs to
/usr/local/bin(or~/.local/binif/usr/local/binis not writable)
Pinning a version¶
VERSION=v0.5.0 curl -fsSL https://raw.githubusercontent.com/johnstegeman/haven/main/install.sh | sh
Build from source¶
Requires Rust 1.75+:
cargo install --git https://github.com/johnstegeman/haven
Supported platforms¶
| Platform | Architectures |
|---|---|
| macOS | arm64 (Apple Silicon), x86_64 (Intel) |
| Linux | x86_64, aarch64, armv7, i686 |
Shell completions¶
After installing, set up tab completions for your shell.
Fish:
haven completions fish > ~/.config/fish/completions/haven.fish
Zsh — add to ~/.zshrc:
source <(haven completions zsh)
Bash — add to ~/.bashrc:
source <(haven completions bash)
Upgrading¶
haven upgrade # upgrade to the latest version
haven upgrade --check # check without installing
haven upgrade --force # reinstall even if already on latest
Next steps¶
- Quick Start — initialize a repo and start tracking files
- New Machine Setup — apply an existing environment to a new machine