Terminal Configuration Repository

This repository contains my personal terminal and development environment configurations for easy backup and setup on new machines.

📦 Contents

Shell Configurations

• .zshrc - Zsh shell configuration
• .zprofile - Zsh profile (loaded before .zshrc)
• .bashrc - Bash shell configuration
• .bash_profile - Bash profile

Development Tools

• .gitconfig - Git configuration
• .tmux.conf - Tmux terminal multiplexer configuration
• nvim/ - Neovim editor configuration

🚀 Quick Setup

Automatic Installation

Run the setup script to automatically backup existing configs and install these configurations:

./setup.sh

This will:

1. Create backups of your existing configurations (in ~/.config-backup-[timestamp])
2. Copy all configurations to their proper locations
3. Set appropriate permissions

Manual Installation

If you prefer to install configurations manually:

Shell Configurations

cp .zshrc ~/.zshrc
cp .zprofile ~/.zprofile
cp .bashrc ~/.bashrc
cp .bash_profile ~/.bash_profile

Git Configuration

cp .gitconfig ~/.gitconfig
# Note: You may want to update user.name and user.email in ~/.gitconfig

Tmux Configuration

cp .tmux.conf ~/.tmux.conf

Neovim Configuration

# Backup existing config if it exists
[ -d ~/.config/nvim ] && mv ~/.config/nvim ~/.config/nvim.backup

# Copy new config
mkdir -p ~/.config
cp -r nvim ~/.config/nvim

Post-Installation

After installing configurations:

1. Reload Shell:

   source ~/.zshrc  # for zsh
   # or
   source ~/.bashrc  # for bash

2. Update Git Config: Edit ~/.gitconfig and update your personal information:

   git config --global user.name "Your Name"
   git config --global user.email "your.email@example.com"

3. Install Neovim Plugins: Open Neovim and it should automatically install configured plugins:

   nvim

🔄 Keeping Configurations Updated

Pull Latest Changes

cd ~/path/to/terminal-config
git pull
./setup.sh  # Re-run setup to apply updates

Push Your Changes

After modifying configurations on your system, copy them back to this repo:

./update-configs.sh  # This will copy current configs back to the repo
git add .
git commit -m "Update configurations"
git push

📋 Prerequisites

Make sure you have the following installed:

• Zsh (recommended) or Bash
• Git
• Tmux (optional, for terminal multiplexing)
• Neovim (for the nvim configuration)

Installing Prerequisites on macOS

brew install zsh git tmux neovim

Installing Prerequisites on Linux (Ubuntu/Debian)

sudo apt update
sudo apt install zsh git tmux neovim

🔧 Customization

Feel free to modify any configuration files to suit your needs. The configurations are well-commented to help you understand what each section does.

📝 Notes

• Always review configuration files before applying them, especially .gitconfig
• The setup script creates backups automatically, but it's good practice to manually backup important configs
• Some configurations may reference specific paths or tools - adjust as needed for your system

🆘 Troubleshooting

Zsh not loading configuration

# Check if .zshrc is being sourced
echo $ZDOTDIR
# Ensure .zshrc exists and is readable
ls -la ~/.zshrc

Neovim plugin issues

# Remove plugin cache and reinstall
rm -rf ~/.local/share/nvim
nvim  # Reopen and let plugins reinstall

Tmux configuration not loading

# Reload tmux configuration
tmux source-file ~/.tmux.conf

📄 License

These are personal configurations. Feel free to use and modify as needed.

---

Last Updated: January 2026