windows-bash-zsh

Configure Git Bash zsh environments on Windows with idempotent profile edits.

14|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/gyf-dev/windows-bash-zsh --skill windows-bash-zsh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: windows-bash-zsh
Source: https://github.com/gyf-dev/windows-bash-zsh/tree/main
Command: npx skills add https://github.com/gyf-dev/windows-bash-zsh --skill windows-bash-zsh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill turns Windows Git Bash into a safer, more ergonomic zsh-based terminal environment, so users can avoid brittle PowerShell quoting issues and get a more Unix-like shell experience without switching to WSL.

Core Features & Use Cases

  • Terminal modernization: Configure Windows Terminal and Git Bash together with zsh, Oh My Zsh, Starship, and a Nerd Font for a cleaner shell setup.
  • Shell repair and migration: Fix or update .bashrc and .zshrc with idempotent, targeted edits that preserve existing user customizations.
  • Developer CLI enhancement: Add fzf, common zsh plugins, and modern tools like bat, ripgrep, lsd, and yazi, plus aliases and preview dependencies when full CLI support is requested.
  • Use case: A developer wants one Windows terminal setup that feels close to macOS or Linux, works well with AI-era CLI workflows, and can be reproduced or rolled back cleanly.

Quick Start

Ask me to set up windows-bash-zsh on your Windows machine, and I will configure Git Bash, zsh, Starship, terminal profiles, and the recommended plugins while preserving your existing shell settings.

Frequently Asked Questions about windows-bash-zsh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up zsh in Git Bash on Windows?

To set up zsh in Git Bash, you can configure Windows Terminal profiles, Oh My Zsh, Starship, and a Nerd Font together. This creates a cleaner, Unix-like shell experience without switching to WSL or dealing with PowerShell quoting issues.

What is the best way to fix a broken zsh configuration in Windows Terminal?

Fixing a broken zsh configuration requires applying idempotent, targeted edits to .bashrc and .zshrc files. This safe profile merging approach repairs the shell environment while strictly preserving your existing user customizations and PATH settings.

Can I use Oh My Zsh and Starship together with Git Bash?

Yes, you can use Oh My Zsh and Starship together with Git Bash. This configuration is supported by applying safe profile merging and shell startup file edits, turning the default Windows Git Bash into a polished and ergonomic zsh shell environment.

Does configuring zsh on Windows overwrite my existing .bashrc settings?

Configuring zsh on Windows does not overwrite your existing settings because the process uses idempotent, targeted edits to .bashrc and .zshrc. This script-driven setup includes fallback behavior to ensure safe profile merging and preserve user customizations.

How do I add modern CLI tools like fzf and ripgrep to a Windows zsh shell?

To add modern CLI tools like fzf, ripgrep, bat, and lsd to a Windows zsh shell, you can enhance the developer CLI setup. This process installs the tools, configures aliases, and handles preview dependencies when full CLI support is requested.

Why use zsh in Git Bash instead of WSL for a Unix-like terminal on Windows?

Using zsh in Git Bash provides a Unix-like terminal experience on Windows without the overhead of switching to WSL. It helps developers avoid brittle PowerShell quoting issues and integrates smoothly with VS Code terminal settings and modern AI-era CLI workflows.