Dotfiles

My personal dotfiles for macOS development environment.

Overview

This repository contains my personal configuration files (dotfiles) for various tools and applications I use in my development workflow. The dotfiles are managed using GNU Stow, which creates symbolic links from this repository to your home directory.

Features

• Modular Configuration: Each tool has its own directory, making it easy to add, remove, or modify configurations.
• ZSH Configuration: Enhanced ZSH setup with Oh-My-Zsh, Powerlevel10k theme, and useful plugins.
• Neovim Setup: Modern Neovim configuration with LSP support, fuzzy finding, and more.
• Tmux Configuration: Productive tmux setup with sensible defaults and useful plugins.
• Git Configuration: Optimized Git configuration with useful aliases and settings.
• macOS Tools: Configuration for macOS-specific tools like Yabai and SKHD.
• Utility Scripts: Collection of useful scripts for development workflow.
• Claude Code Plugins: Personal Claude Code plugins for workflow automation (e.g., tmux session status).

Directory Structure

.
├── alacritty/        # Alacritty terminal configuration
├── bash/             # Bash shell configuration
├── claude/           # Claude Code behavioral guidelines
├── emacs/            # Emacs configuration
├── git/              # Git configuration and aliases
├── hammerspoon/      # Hammerspoon configuration
├── my-plugins/       # Personal Claude Code plugins
├── nvim/             # Neovim configuration
├── scripts/          # Utility scripts
├── skhd/             # Simple Hotkey Daemon configuration
├── tmux/             # Tmux configuration
├── yabai/            # Yabai window manager configuration
└── zsh/              # ZSH shell configuration

Installation

Prerequisites

• Git
• GNU Stow

Manual Installation

If you prefer to install manually or want to install only specific configurations:

# Install GNU Stow
brew install stow  # macOS with Homebrew

# Clone the repository
git clone https://github.com/minhyeoky/dotfiles.git ~/dotfiles

# Navigate to the dotfiles directory
cd ~/dotfiles

# Install specific configurations (e.g., zsh, nvim, tmux)
stow zsh
stow nvim
stow tmux

Claude Code Plugins

The my-plugins/ directory contains personal Claude Code plugins, registered via a local marketplace (.claude-plugin/marketplace.json).

To install, open Claude Code in this repo and run:

/plugin marketplace add .
/plugin install my-plugins@my-plugins

See my-plugins/README.md for available plugins and details.

Available Configurations

The following configurations are available:

• alacritty: Configuration for Alacritty terminal emulator
• bash: Bash shell configuration
• claude: Claude Code behavioral guidelines (CLAUDE.md)
• emacs: Emacs configuration
• git: Git configuration and aliases
• hammerspoon: Hammerspoon configuration for macOS automation
• my-plugins: Personal Claude Code plugins (tmux-status hooks)
• nvim: Neovim configuration
• skhd: Simple Hotkey Daemon configuration
• tmux: Tmux configuration
• yabai: Yabai window manager configuration
• zsh: ZSH shell configuration

Environment Secrets

Sensitive information like API keys should be stored in ~/.env_secrets, which is sourced by Bash but not tracked by Git.

License

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

Acknowledgments

• Oh-My-Zsh
• Powerlevel10k
• Tmux Plugin Manager
• Neovim
• GNU Stow
• Claude Code