dotfiles

Minimal personal zsh setup for macOS. No Homebrew, no oh-my-zsh — just:

• A handful of aliases and helper functions
• Starship for the prompt
• FiraCode Nerd Font + a matching Terminal.app profile
• zsh-autosuggestions for history-based command suggestions

Install

git clone https://github.com/RenegadeFox/dotfiles.git ~/.dotfiles && zsh ~/.dotfiles/install.sh

When the script finishes, a new Terminal window will open using the FiraCode profile with the Starship prompt. That window is the signal that the install is done — you can close the original.

Installer flags

Skip parts of the install that don't apply to your machine:

zsh ~/.dotfiles/install.sh --no-terminal      # skip Terminal.app profile setup
zsh ~/.dotfiles/install.sh --no-fonts         # skip font installation
zsh ~/.dotfiles/install.sh --no-starship      # skip Starship installation
zsh ~/.dotfiles/install.sh --no-autosuggest   # skip zsh-autosuggestions installation

Flags can be combined:

zsh ~/.dotfiles/install.sh --no-terminal --no-fonts

Run zsh ~/.dotfiles/install.sh --help for the full list.

What the installer does

1. Backs up any existing ~/.zshrc and ~/.config/starship.toml to ~/.dotfiles_backup/<timestamp>/.
2. Renders zsh/zshrc with the actual repo path baked in and symlinks it to ~/.zshrc.
3. Symlinks starship/starship.toml → ~/.config/starship.toml.
4. Clones zsh-autosuggestions into plugins/.
5. Copies fonts/*.ttf into ~/Library/Fonts/ (no sudo needed).
6. Installs Starship to ~/.local/bin (no Homebrew required).
7. Imports the FiraCode.terminal profile and sets it as the default for Terminal.app.

Steps 4–7 can each be skipped with the --no-* flags above. The installer is idempotent — safe to re-run. Existing configs are backed up, and plugins that are already installed are skipped.

Layout

.
├── README.md
├── install.sh
├── .gitignore
├── fonts/                   # FiraCode Nerd Font TTFs
├── plugins/                 # cloned at install time, git-ignored
│   └── zsh-autosuggestions/
├── starship/
│   └── starship.toml        # → ~/.config/starship.toml
├── terminal/
│   └── FiraCode.terminal    # exported Terminal.app profile
└── zsh/
    ├── zshrc                # template → rendered to zshrc.generated → ~/.zshrc
    └── aliases.zsh          # sourced from zshrc

Commands

Run aliases in the terminal to see this list at any time.

Command	Description
bundleid	Get the bundle ID of an app from the passed in path
c	Clear the terminal
ll	List directory contents (long format)
cll	Clear terminal then list directory contents
cdl	Change directory and list contents
df-update	Pull latest dotfiles and reload shell
df-reinstall	Re-run the dotfiles installer
df-regen	Re-generates the zshrc.generated file based on the zsh template file and reloads the shell
aliases	Show all available commands

Edit or add aliases in zsh/aliases.zsh. Changes take effect on the next shell or after running df-update.

Updating

From any directory:

df-update

This pulls the latest changes from the repo and reloads the shell. If the update includes changes to fonts, the Terminal profile, or install.sh itself, run df-reinstall instead (flags are supported):

df-reinstall
df-reinstall --no-terminal

Uninstall

rm ~/.zshrc
rm ~/Library/Fonts/FiraCode*.ttf
rm ~/.config/starship.toml
rm -rf ~/.dotfiles
# To remove Starship: rm "$(which starship)"
# In Terminal > Settings, switch the default profile back to "Basic"
# and delete the FiraCode profile.