SkillAgentSearch skills...

Dotfiles

✨ A meticulously crafted macOS development environment featuring a modern, efficient, and aesthetically pleasing setup. Includes configurations for Neovim, Zsh, Tmux, Ghostty/Kitty, and more, all managed through GNU Stow for seamless dotfile management.

Install / Use

/learn @PraveenGongada/Dotfiles
About this skill

Quality Score

0/100

Supported Platforms

Universal

README

<div align="center"> <img src="https://capsule-render.vercel.app/api?type=waving&color=0:02569B,100:005078&height=200&section=header&text=~/dotfiles&fontSize=60&fontColor=ffffff&animation=fadeIn&fontAlignY=38" alt="Dotfiles Banner"/> <br/> <img src="https://img.shields.io/badge/platform-macOS-lightgrey?style=for-the-badge&logoColor=black" alt="Platform: macOS"/> <img src="https://img.shields.io/github/stars/PraveenGongada/dotfiles?style=for-the-badge" alt="Stars"/> <img src="https://img.shields.io/github/forks/PraveenGongada/dotfiles?style=for-the-badge" alt="Forks"/> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-02569B?style=for-the-badge" alt="License: MIT"/></a>

A carefully curated collection of configuration files for a productive development environment

</div>

📸 Screenshots

<div align="center"> <img src="./docs/images/nvim.png" alt="Terminal Setup"/> <img src="./docs/images/desktop.png" alt="Desktop Environment"/> </div>

For more screenshots, see Showcase

📦 What's Inside

This repository contains configuration files for various tools and applications:

  • zshrc - Z Shell configuration
  • nvim - Neovim configuration
  • tmux - Terminal multiplexer configuration
  • ghostty - GPU-accelerated terminal emulator
  • kitty - GPU-based terminal emulator
  • wezterm - GPU-accelerated cross-platform terminal emulator
  • lazygit - Terminal UI for git commands
  • sketchybar - macOS status bar replacement
  • aerospace - Window manager for macOS
  • yazi - Terminal file manager
  • oh-my-posh - Prompt theme engine
  • homebrew - Package manager backup
  • fonts - Custom fonts collection
  • wallpapers - Custom wallpapers

🚀 Installation

Prerequisites

Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Git & Stow

brew install git stow

Setup Steps

1. Clone

cd ~ && git clone git@github.com:PraveenGongada/dotfiles.git
cd dotfiles

2. Symlink

stow .

3. Configure ZSH

echo 'export ZDOTDIR="$HOME/.config/zshrc"' >> ~/.zshenv

4. Install Packages

xargs brew install < ~/.config/homebrew/leaves.txt
xargs brew install --cask < ~/.config/homebrew/casks.txt

Backup Homebrew Packages

brew leaves -r > ~/.config/homebrew/leaves.txt
brew list --cask > ~/.config/homebrew/casks.txt

Install Custom Fonts

⚠️ Warning
This will overwrite any fonts with the same name in your system

find ~/.config/fonts/default/ -type f \( -name '*.ttf' -o -name '*.otf' \) -exec cp {} ~/Library/Fonts/ \;
find ~/.config/fonts/store/ -type f \( -name '*.ttf' -o -name '*.otf' \) -exec cp {} ~/Library/Fonts/ \;

To install a specific font:

find ~/.config/fonts/$PATH_TO_FONT/ -type f \( -name '*.ttf' -o -name '*.otf' \) -exec cp {} ~/Library/Fonts/ \;

Additional Setup

Some components require additional setup steps after installation:

  • SketchyBar: See SketchyBar README for icons installation and configuration steps
  • Tmux: See TMUX README for TPM installation and plugin setup

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • GNU Stow for symlink management
  • All the open-source projects that made these configurations possible

Related Skills

View on GitHub
GitHub Stars106
CategoryDevelopment
Updated7d ago
Forks5

Languages

Lua

Security Score

100/100

Audited on Mar 19, 2026

No findings