I would be happy to learn why and how I am wrong here.

Is there a chance that fact that my .bashrc is a symbolic link to repo with my dotfiles may be breaking something? (for reference: https://github.com/matkoniecz/my_public_dotfiles )

Hi, thx for the PR!

I agree the instructions are not very clear/thorough.

In fact the command without - i.e. git something works for me, but I'm based on Windows (using git bash), but it's not trivial how it's supposed to work.

There's some built-in mechanism in git that if you run git something it will run git-something script. This script must be in $PATH and be executable:

https://blog.dreamfactory.com/extending-git-with-a-custom-command/

So you'd need to chmod u+x the new file if you copy it somewhere.

If you just copy a bash function directly to your .bashrc, you'd have to reload your terminal session (and perhaps something more).

In addition to last statement, on my side I put helpers not into .bashrc anymore but into .profile. Whenever I change something, I have to source ~/.profile to have my shell reloaded with the newly added things.

not sure what went wrong here, I admit that I have not time to investigate that