Skip to content

Instantly share code, notes, and snippets.

Last active February 27, 2024 09:30
Star You must be signed in to star a gist
Save fworks/af4c896c9de47d827d4caa6fd7154b6b to your computer and use it in GitHub Desktop.
Zsh / Oh-my-zsh on Windows Git Bash


  1. Download the latest zsh package:




The package now is compacted using zstd, so now we need some "special" extractor.
So, in my case, I've downloaded this file And extracted it using the Peazip.

  1. Extract the content to your git bash installation dir:

Usually C:\Program Files\Git

  1. Test it and config zsh:

Open git bash and type:


So, this step is important, it seems zsh will ask a few configurations, like the tab completion, history, etc.
Please read the options and set that according to your use.

  1. Installing oh-my-zsh, execute the following cmd on git bash
sh -c "$(curl -fsSL"
  1. Configuring zsh as default shell

Edit the ~/.bashrc file. (create it if it doesn't exist)

Add the following lines at the end of the file

# Launch Zsh
if [ -t 1 ]; then
exec zsh

Close and open again the git bash.

Optional steps

  1. Installing the Honukay theme
curl -fsSL -o ~/.oh-my-zsh/custom/themes/honukai.zsh-theme
  1. Set it
sed -i 's/ZSH_THEME="robbyrussell"/ZSH_THEME="honukai"/g' ~/.zshrc
Copy link

kissingfire123 commented Jun 6, 2023

I noticed an issue with root directory autocompletion when I type for example "/c/use" and hit tab it won't find it, except in git bash I could get the autocompletion correctly and with capitalized folders like "/c/Users"

I ran into this problem also. inspired by @LionH , I founded a way to work around 🥇

#  after cd to c: , you will find you can complete by tab 
cd c:
cd Users/yourxxxPath  

the problem is zsh can't receive the sequences of windows-way. I tried stackoverflow: zsh-tab-completion-not-working and rehash-zsh guide, they didn't helped either.

Copy link

Putting this in .bashrc breaks anything trying to directly run bash commands.

if [ -t 1 ]; then
    exec zsh

Didn't anyone else run into problems with VS Code because of this? I came looking for a fix but was surprised to see nobody mentioned it. For example VSCode runs npm scripts like "C:\Program Files\Git\bin\bash.exe '--login', '-i', '-c', 'npm run watch'", which doesn't work anymore.

Try to open cmd and run "C:\Program Files\Git\bin\bash.exe" --login -i -c "echo hello" and see it opens zsh but never echos anything.

Doing this instead seems to fix it:

# Check for BASH_EXECUTION_STRING to see if bash is being called with -c to execute a command.
if [[ -z "$BASH_EXECUTION_STRING" && -t 1 ]]; then
    exec zsh

Copy link

rombat commented Oct 12, 2023

any idea what could cause this issue when trying to install oh-my-zsh ?

Copy link

mamboer commented Oct 31, 2023

install zsh-autosuggestions plugin

  1. git clone $ZSH/plugins/zsh-autosuggestions
  2. source $ZSH/plugins/zsh-autosuggestions/zsh-autosuggestions.zsh
  3. edit ~/.zshrc file

install zsh-syntax-highlighting plugin

  1. git clone git clone $ZSH/plugins/zsh-syntax-highlighting
  2. source $ZSH/plugins/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh
  3. edit ~/.zshrc file

Cool. I will test that later. Thanks for that.

Change $ZSH to $ZSH_CUSTOM will be better.

Copy link

Install Git Bash with ZSH, OH MY ZSH & POWERLEVEL10K | Windows Guide

Thanks to all of you guys i've create a fork of fworks works and your guys' suggestion in the comment.

Copy link


guys, does anyone know how to remove this? What they write doesn't help. I tried using -f to run the function and it still appears

Copy link


My name is Erick Shil, I'm begginer brazilian dev and I have only one problem, that I didn't find solution anywhere.

Screenshot 2024-02-17 172921
Always when Hyper start, this message it's printed, and I don't know how to solve this question. In StackOverflow, nobody alredy have the same problem. Can you help me?


  • Lenovo Ideapad 3
  • Ryzen 7 5700
  • 128GB SSD
  • 8GB RAM

(ps. Sorry for the bad English. As a developer (and understanding the importance of English, since we only speak Portuguese here), I am trying to train English without a translator...)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment