This repository contains an automated, highly-optimized Zsh configuration designed for macOS. It seamlessly integrates modern CLI tools (Zoxide, Atuin, Oh My Posh) while maintaining strict compatibility and safety when switching to the root user.
- One-Line Installation: Fully automated setup script via
curl. - Root-Safe Architecture: Intelligently disables user-only plugins and Homebrew environment triggers when running as
rootto prevent permission errors (command not found: compdefor JWS JSON errors). - Automated Backups: Safely backs up existing
.zshrcand repository directories with a precise datetime stamp before making any changes. - Shared Theming: Automatically clones and symlinks your custom Oh My Posh theme so both your local user and
rootshare the exact same visual prompt. - Fast Loading: Uses
znapfor asynchronous plugin loading.
Before installing, ensure your macOS system has the following core utilities installed:
- Zsh: (Default on modern macOS).
- Git: Required to clone this repository and download plugins.
- Homebrew: The package manager used for almost all tooling.
sh -c "$(curl -fsSL https://raw.githubusercontent.com/Nickael/config/main/tools/install.sh)"
The configuration expects the following tools to be installed via Homebrew. If they are missing, the shell will still load, but certain features will be disabled:
brew install atuin zoxide oh-my-posh