Personal configuration files for a productive development environment using zsh, Neovim, and tmux.

# One-liner bootstrap (clones + installs)
curl -fsSL https://raw.githubusercontent.com/chussenot/dotfiles/master/bootstrap.sh | sh

# Or with a profile
curl -fsSL https://raw.githubusercontent.com/chussenot/dotfiles/master/bootstrap.sh | sh -s -- --minimal

Primary Test Environment: Ubuntu 24.04.3 LTS (kernel 6.14.0-1015-oem)

See docs/MULTI_PLATFORM.md for detailed platform information.

Before running the installer, ensure you have:

git clone https://github.com/chussenot/dotfiles.git ~/.dotfiles
cd ~/.dotfiles

# Check platform detection
./scripts/utils/debug_platform.sh

# Review the install script
less install.sh

./install.sh              # default profile
./install.sh --minimal    # shell + editor only (fast, for containers)
./install.sh --full       # everything including infra & offensive tools

exec zsh
# Or close and reopen your terminal

# Local vim overrides
vim ~/.vim/vimrc.local

# Local zsh configuration
vim ~/.zshrc.local

The installer performs these steps in order:

1. Backup - Creates timestamped backup of existing dotfiles in ~/.dotfiles_backup/
2. Install packages - Installs system packages via your platform's package manager
3. Install Antidote - Clones the zsh plugin manager to ~/.antidote
4. Create symlinks - Links configuration files to your home directory
5. Install mise - Downloads the tool version manager
6. Install dev tools - Uses mise to install Python, Node.js, Go, etc.
7. Install Neovim plugins - Runs :PlugInstall in headless mode
8. Install zsh theme - Sets up the custom chussenot theme

The installer includes several safety measures:

• Automatic backups: All existing dotfiles are backed up before modification
• Non-destructive: Existing files are moved to .backup suffix, not deleted
• Root protection: Refuses to run as root user
• Error handling: Continues on non-critical failures with warnings
• Idempotent: Safe to run multiple times

If something goes wrong, restore your original configuration:

# Find your backup
ls ~/.dotfiles_backup/

# Restore specific files
cp ~/.dotfiles_backup/YYYYMMDD_HHMMSS/.zshrc ~/.zshrc

# Or restore everything
cp -r ~/.dotfiles_backup/YYYYMMDD_HHMMSS/* ~/

To remove the dotfiles and restore your original configuration:

# 1. Remove symlinks (they point to ~/.dotfiles)
rm ~/.zshrc ~/.tmux.conf ~/.inputrc ~/.config/nvim

# 2. Restore from backup
cp -r ~/.dotfiles_backup/YYYYMMDD_HHMMSS/* ~/

# 3. Remove the dotfiles directory (optional)
rm -rf ~/.dotfiles

# 4. Remove installed tools (optional)
rm -rf ~/.antidote ~/.local/share/mise

See docs/TROUBLESHOOTING.md for common issues and solutions.

Installation fails with "permission denied":

# Ensure scripts are executable
chmod +x install.sh scripts/**/*.sh

"git not found" or "curl not found":

# Ubuntu/Debian
sudo apt-get install git curl

# macOS
xcode-select --install

Symlinks not working:

# Re-run symlink setup
./scripts/setup/setup-symlinks.sh

Neovim plugins not loading:

# Manually install plugins
nvim +PlugInstall +qall

The chussenot theme displays:

• User, host, and current directory
• Git branch and status (clean/dirty indicators)
• Python, Node.js, Go versions (configurable)
• System load with color coding
• Background jobs count
• Active Python virtualenv
• Docker container indicator
• Non-zero exit codes

Configure features via environment variables - see configs/shell/chussenot.zsh-theme.

Plugin manager: vim-plug

All NeoVim-specific plugins are has('nvim') guarded and Lua configs are pcall guarded, so regular Vim starts without errors.

See configs/editor/nvim/KEYMAPS.md for keyboard shortcuts, or run help in your shell.

• Multi-Platform Support - Platform detection and package management
• POSIX Compliance - Shell script standards
• Troubleshooting - Common issues and solutions

Contributions to improve cross-platform compatibility are welcome. Please ensure shell scripts pass:

shellcheck --shell=sh script.sh

MIT