From 7ba993cbfb31fd3a7340fdba882232f1db826da2 Mon Sep 17 00:00:00 2001 From: Tom Boucher Date: Tue, 17 Mar 2026 20:41:04 -0400 Subject: [PATCH] docs: add troubleshooting for oh-my-zsh gsd alias collision (#722) (#1051) oh-my-zsh's git plugin defines alias gsd='git svn dcommit' which shadows the GSD binary. Added troubleshooting section to getting-started.md with two solutions: unalias in .zshrc, or use the gsd-cli alternative binary name. --- docs/getting-started.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/getting-started.md b/docs/getting-started.md index 570753b49..68599f171 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -151,3 +151,23 @@ Shows each session's date, message count, and first-message preview so you can c - [Auto Mode](./auto-mode.md) — deep dive into autonomous execution - [Configuration](./configuration.md) — model selection, timeouts, budgets - [Commands Reference](./commands.md) — all commands and shortcuts + +## Troubleshooting + +### `gsd` command runs `git svn dcommit` instead of GSD + +The [oh-my-zsh git plugin](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git) defines `alias gsd='git svn dcommit'`, which shadows the GSD binary. + +**Option 1** — Remove the alias in your `~/.zshrc` (add after the `source $ZSH/oh-my-zsh.sh` line): + +```bash +unalias gsd 2>/dev/null +``` + +**Option 2** — Use the alternative binary name: + +```bash +gsd-cli +``` + +Both `gsd` and `gsd-cli` point to the same binary.