https://github.com/justintime50/alchemist
Update, backup, and administer your Homebrew or Chocolatey instance.
https://github.com/justintime50/alchemist
alchemist automate backup brew chocolatey homebrew instance packages update upgrade
Last synced: 14 days ago
JSON representation
Update, backup, and administer your Homebrew or Chocolatey instance.
- Host: GitHub
- URL: https://github.com/justintime50/alchemist
- Owner: Justintime50
- License: mit
- Created: 2019-12-27T16:38:32.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-11-23T06:39:54.000Z (over 1 year ago)
- Last Synced: 2025-03-31T17:59:31.014Z (12 months ago)
- Topics: alchemist, automate, backup, brew, chocolatey, homebrew, instance, packages, update, upgrade
- Language: Go
- Homepage:
- Size: 1.46 MB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Alchemist
Update, backup, and administer your Homebrew or Chocolatey instance.
[](https://github.com/Justintime50/alchemist/actions)
[](https://app.codecov.io/github/Justintime50/alchemist)
[](https://github.com/Justintime50/alchemist/releases)
[](LICENSE)
> Bubble bubble, toil and brew...
## Install
### macOS and Linux
```bash
# Setup the tap
brew tap justintime50/formulas
# Install the tool
brew install alchemist
```
### Windows
Download the Windows binary from the [releases page](https://github.com/Justintime50/alchemist/releases).
## Usage
## Alchemist Backup
Alchemist can backup your entire Homebrew (macOS and Linux) or Chocolatey (Windows) instance. It does this by retrieving the list of installed packages and creating a script that can be run to restore your entire Homebrew or Chocolatey instance.
```bash
alchemist --backup
```
If you run into troubles backing up your Homebrew instance, it's recommended to try running Alcehmist with the `--update` flag first.
## Alchemist Update
### macOS and Linux
Alchemist automates the entire Homebrew update process including:
1. Updating available taps and formula references
1. Upgrading formula
1. Upgrading casks (macOS)
1. Cleaning up old/stale taps and formula
1. Checking for problems with your Homebrew instance
### Windows
Alchemist will update all of your Chocolatey packages:
```bash
alchemist --update
```
### Logs
Alchemist saves logs to `~/alchemist/update/alchemist-update.log`. Logs by default are kept on the system for `90 days` and are automatically rotated for you once their size exceeds 1mb or the logs become older than 90 days.
### Restore Scripts
Scripts generated from the backup functionality of Alchemist live at `~/alchemist/backup`. Simply run `brew bundle --file path/to/Brewfile` or `path/to/restore-choco-packages.bat` to restore your packages.
```text
Usage:
alchemist --update
Options:
--backup
Backup your Homebrew instance.
--update
Update your Homebrew instance.
--greedy
Greedily updates casks even if they have auto-update capabilities in their respective UIs.
```
## Development
```shell
# Get a comprehensive list of development tools
just --list
```