doc: add readme to zsh

2026-07-03 00:11:52 +02:00
parent 75d6aae668
commit f48d68da9d
1 changed files with 31 additions and 0 deletions
@@ -0,0 +1,31 @@
+# zsh configuration
+
+## Features
+
+- **Powerlevel10k** theme with instant prompt
+- **Syntax highlighting** for commands
+- **Autosuggestions** based on history
+- **fzf integration** (Ctrl+R history, Ctrl+T files, Alt+C directories)
+- **fzf-tab** for completion menus
+- **Smart aliases** (docker → podman)
+- **Persistent history** across sessions
+
+## Configuration
+
+### Users
+
+Configure users in inventory:
+
+```yaml
+zsh_users:
+  - jsmith
+  - root
+```
+
+## Keybindings
+
+- `↑/↓` - History search with substring matching
+- `Ctrl+R` - Fuzzy history search
+- `Ctrl+T` - Fuzzy file search
+- `Alt+C` - Fuzzy directory change
+- `Tab` - fzf completion menu