diff --git a/README.md b/README.md
index 7a9ddb2..df2db32 100644
--- a/README.md
+++ b/README.md
@@ -57,11 +57,16 @@ uv pip install -e .     # or: pip install -e .
 Optional extras (none are required; the core install is lean and works on Python 3.11 through 3.14):
 
 ```bash
-pip install cgh[langs]   # C# and Ruby parsers (tree-sitter grammars)
-pip install cgh[lsp]     # precise cross-file Python call resolution (jedi)
-pip install cgh[kuzu]    # the legacy Kuzu graph backend (DuckDB is the default)
+pip install "cgh[langs]"   # C# and Ruby parsers (tree-sitter grammars)
+pip install "cgh[lsp]"     # precise cross-file Python call resolution (jedi)
+pip install "cgh[kuzu]"    # the legacy Kuzu graph backend (DuckDB is the default)
+
+# Combine extras in one bracket, comma-separated:
+pip install "cgh[langs,lsp]"
 ```
 
+Quote the package spec (`"cgh[...]"`) so zsh and bash do not try to glob the brackets. The same form works with `pipx install`, `uv tool install`, `uv pip install`, and from a source checkout: `pip install -e ".[langs,lsp]"`.
+
 ```bash
 cgh --version
 cgh init           # initialize in any project