Prometheus Dotfiles
Minimal, fast macOS setup — Tokyo Night themed from terminal to taskbar. One install script. Everything symlinked. Always in sync with git.
Quick Install
Clone the repo, run the script. It handles Homebrew, packages, symlinks, and shell config.
# Clone git clone https://github.com/rafay99-epic/dotfiles.git ~/dotfiles cd ~/dotfiles # Run installer chmod +x install.sh ./install.sh
./install.sh --dry-run
./install.sh --help
Applications
Every tool used across the Zsh and Fish shell configs. All installable via Homebrew — the install script handles the full list automatically.
brew install starship fastfetch bat eza fzf thefuck rbenv nvm fish lsd scrcpy openjdk@17 brew install --cask lm-studio windsurf flutter # Claude Code (cc alias) npm install -g @anthropic-ai/claude-code
CLI Tools
| Tool | Purpose | Install |
|---|---|---|
| starship | Cross-shell prompt (used in both Zsh and Fish) | |
| fastfetch | System info displayed on every shell open | |
| bat | Syntax-highlighted cat replacement (cat alias) |
|
| eza | Modern ls with icons (ls alias) |
|
| lsd | Alternative ls replacement (referenced in Fish aliases) | |
| fzf | Fuzzy finder — Ctrl+R history, Ctrl+T file search | |
| thefuck | Corrects previous mistyped command | |
| scrcpy | Android screen mirror / recording (scrcpy120 alias) |
|
| fish | Friendly interactive shell |
Runtime Managers
| Tool | Purpose | Install |
|---|---|---|
| rbenv | Ruby version manager | |
| nvm | Node version manager (Zsh). Fish: use nvm.fish plugin |
|
| bun | Fast JavaScript runtime and package manager | |
| openjdk@17 | Java 17 (required for Flutter / Android builds) | |
| conda | Python environment manager (Anaconda distribution) |
GUI Apps
| App | Purpose | Install |
|---|---|---|
| flutter | Flutter SDK — cross-platform mobile / desktop framework | |
| lm-studio | Run local LLMs — CLI via lms |
|
| windsurf | AI-powered IDE by Codeium |
Manually Installed
| Tool | How to install |
|---|---|
| claude (cc) | |
| nvm.fish | |
| opencode | Install from opencode.ai |
| kiro | AI IDE — install from kiro.dev |
How Symlinks Work
The dotfiles repo is the source of truth.
Every config file is symlinked from ~/.config/ back into this repo —
so edits are instantly live and automatically tracked by git.
~/.config/sketchybar → ~/dotfiles/sketchybar/ ~/.config/aerospace/aerospace.toml → ~/dotfiles/aerospace/aerospace.toml ~/.config/ghostty/config → ~/dotfiles/ghostty/config ~/.config/starship.toml → ~/dotfiles/starship/starship.toml ~/.config/lsd/config.yaml → ~/dotfiles/lsd/config.yaml ~/.config/fastfetch/config.jsonc → ~/dotfiles/fastfetch/config.jsonc ~/.zshrc → ~/dotfiles/zsh/.zshrc ~/.config/fish/config.fish → ~/dotfiles/fish/config.fish
readlink ~/.config/sketchybar readlink ~/.config/aerospace/aerospace.toml readlink ~/.config/ghostty/config readlink ~/.config/starship.toml readlink ~/.config/lsd/config.yaml readlink ~/.zshrc readlink ~/.config/fish/config.fish
SketchyBar
Floating, notch-aware menu bar replacement. Two frosted-glass pills sit on either side of the MacBook notch.
brew tap FelixKratz/formulae brew install sketchybar brew services start sketchybar # App font (workspace icons) curl -fsSL https://github.com/kvndrsslr/sketchybar-app-font/releases/download/v2.0.28/sketchybar-app-font.ttf \ -o ~/Library/Fonts/sketchybar-app-font.ttf # Symlink + reload ln -sf ~/dotfiles/sketchybar ~/.config/sketchybar sketchybar --reload
sketchybar --reload
brew services restart sketchybar
brew services list | grep sketchybar
Color Scheme
| Variable | Color | Use |
|---|---|---|
| BAR_COLOR | #1a1b26 | Bar / pill background |
| ACCENT_COLOR | #7aa2f7 | Active space · Wi-Fi |
| PURPLE | #bb9af7 | Calendar icon |
| CYAN | #7dcfff | Volume icon |
| GREEN | #9ece6a | Battery full · AI low |
| YELLOW | #e0af68 | Battery mid · AI mid |
| RED | #f7768e | Battery low · AI high |
AeroSpace
i3-inspired tiling window manager for macOS. Vim-style keybindings, workspace-based layout.
brew tap nikitabobko/tap brew install --cask nikitabobko/tap/aerospace mkdir -p ~/.config/aerospace ln -sf ~/dotfiles/aerospace/aerospace.toml ~/.config/aerospace/aerospace.toml
Ghostty
GPU-accelerated terminal. Tokyo Night theme, JetBrains Mono Nerd Font, tabs, splits, clipboard.
brew install --cask ghostty mkdir -p ~/.config/ghostty ln -sf ~/dotfiles/ghostty/config ~/.config/ghostty/config
| Feature | Value |
|---|---|
| Theme | Tokyo Night (built-in) |
| Font | JetBrains Mono Nerd Font · 13pt |
| Background | 95% opacity + blur radius 20 |
| Working dir | ~ on every new tab/window |
| Scrollback | 10 MB |
| Copy on select | Enabled |
| Key | Action |
|---|---|
| ⌘ T | New tab |
| ⌘ W | Close tab / split |
| ⌘ ] / ⌘ [ | Next / previous tab |
| ⌘ 1–8 | Jump to tab |
| Ctrl + Tab | Next tab |
Shell Tools
lsd · Starship prompt · Fastfetch · CodexBar AI tracker
brew install lsd # Add to ~/.zshrc alias ls='lsd' alias ll='lsd -la' alias lt='lsd --tree'
brew install starship # Add to ~/.zshrc eval "$(starship init zsh)"
brew install fastfetch # Add to ~/.zshrc fastfetch
Install from github.com/steipete/CodexBar, then log in to Claude and Gemini via the menu bar app. The SketchyBar widget reads live usage automatically.
Useful Commands
SketchyBar
sketchybar --reloadbrew services restart sketchybarbrew services stop sketchybarAeroSpace
aerospace reload-configaerospace list-windows --allaerospace list-workspaces --allZsh
Default shell on macOS. Configured with Starship prompt, fzf fuzzy finder, lsd/eza aliases, git shortcuts, and fastfetch on open.
# Symlink your zsh config ln -sf ~/dotfiles/zsh/.zshrc ~/.zshrc
What's included
| Feature | Details |
|---|---|
| Prompt | Starship — cross-shell, fast, Tokyo Night compatible |
| Fuzzy finder | fzf with custom Tokyo Night colour scheme |
| ls replacement | eza with icons — ls alias |
| cat replacement | bat — syntax-highlighted output |
| System info | fastfetch runs on every new shell open |
| Runtime managers | nvm · conda · rbenv · bun |
| Plugin | zsh-autosuggestions |
Aliases
| Alias | Command |
|---|---|
ls | eza --icons=always |
cat | bat |
cc | claude (Claude Code) |
gs | git status |
g | git |
gc | git clone |
ga | git commit -a |
branch | git branch -r |
brew install fzf eza bat starship fastfetch zsh-autosuggestions
Fish
Friendly interactive shell. Starship prompt, lsd for ls, git aliases, conda, and fastfetch — same workflow as Zsh but with fish's autocompletion out of the box.
brew install fish mkdir -p ~/.config/fish ln -sf ~/dotfiles/fish/config.fish ~/.config/fish/config.fish # Register fish + set as default shell (optional) echo $(which fish) | sudo tee -a /etc/shells chsh -s $(which fish)
What's included
| Feature | Details |
|---|---|
| Prompt | Starship — starship init fish | source |
| Greeting | Disabled (fastfetch replaces it) |
| System info | fastfetch on every shell open |
| ls replacement | lsd -al — ls alias |
| cat replacement | bat — cat alias |
| Runtime managers | conda · bun · LM Studio |
Aliases
| Alias | Command |
|---|---|
ls | lsd -al |
cat | bat |
gs | git status |
g | git |
gc | git clone |
ga | git commit -a |
branch | git branch -r |