aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorEugene Triguba <eugene.triguba@paymentworks.com>2025-06-28 11:19:15 -0400
committerEugene Triguba <eugene.triguba@paymentworks.com>2025-06-28 11:19:15 -0400
commit1bb191f3ab8460f87cc981c631439fcb5e39db49 (patch)
tree17256981b1d33629bc566ece0ce1f3e16c8227d2 /README.md
parenttweak linters (diff)
parentupdate readme (diff)
downloaddotfiles-1bb191f3ab8460f87cc981c631439fcb5e39db49.zip
Merge remote-tracking branch 'upstream'
Diffstat (limited to 'README.md')
-rw-r--r--README.md24
1 files changed, 19 insertions, 5 deletions
diff --git a/README.md b/README.md
index c0d73b8..852131f 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,28 @@
# Dotfiles
-Personal dotfiles.
+These are my personal dotfiles for macOS systems.
+
+All configuration files are managed using [GNU Stow](https://www.gnu.org/software/stow/), which automatically creates symlinks from this repository to the appropriate locations in your `$HOME` directory. The repository also includes scripts for managing and syncing your Homebrew packages via a Brewfile.
## Installation
-To get the repo and install the dotfiles, you'll want to do a git clone and run the included shell script.
+Clone the repository (recommended: `~/.dotfiles`) and run the installation script:
-```
-git clone git@github.com:eugenetriguba/dotfiles.git
-cd dotfiles
+```sh
+git clone git@github.com:eugenetriguba/dotfiles.git ~/.dotfiles
+cd ~/.dotfiles
chmod u+x install.sh
./install.sh
```
+
+## Homebrew Packages
+
+To update your `homebrew/Brewfile` with your currently installed Homebrew formulae and casks, run:
+
+```sh
+chmod u+x homebrew/sync-brewfile.sh
+./homebrew/sync-brewfile.sh
+```
+
+This script only updates the `homebrew/Brewfile` with your current manually installed Homebrew packages; it does not install or remove any packages. You can then use `git diff` to review the changes.
+