pzsh 0.3.4

Performance-first shell framework with sub-10ms startup
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

# Migration from oh-my-zsh

pzsh provides oh-my-zsh compatible features with sub-10ms startup. This guide helps you migrate.

## Quick Migration

1. Install pzsh:
   ```bash
   cargo install pzsh
   ```

2. Initialize configuration:
   ```bash
   pzsh init --shell zsh
   ```

3. Add to `~/.zshrc`:
   ```bash
   eval "$(pzsh compile)"
   ```

4. Remove oh-my-zsh:
   ```bash
   # Comment out or remove:
   # source $ZSH/oh-my-zsh.sh
   ```

## Feature Mapping

| oh-my-zsh | pzsh | Status |
|-----------|------|--------|
| Colored prompt | `[prompt] colors = true` | ✓ |
| Git branch display | Built-in prompt | ✓ |
| Git dirty indicator | Built-in prompt | ✓ |
| git plugin aliases | `plugins = ["git"]` | ✓ |
| docker plugin | `plugins = ["docker"]` | ✓ |
| Themes | robbyrussell, agnoster, etc. | ✓ |
| Auto-suggestions | Built-in widget | ✓ |
| Syntax highlighting | Built-in widget | ✓ |
| History search | Built-in widget | ✓ |
| Directory jump (z) | Built-in z command | ✓ |
| Completion system | Native zsh + extensions | ✓ |

## Alias Migration

Copy your aliases to `~/.pzshrc`:

**oh-my-zsh:**
```zsh
alias ll="ls -la"
alias gst="git status"
```

**pzsh:**
```toml
[aliases]
ll = "ls -la"
gst = "git status"
```

## Plugin Migration

### Git Plugin

oh-my-zsh git aliases are built-in:

```toml
[plugins]
enabled = ["git"]
```

Provides: `g`, `gs`, `ga`, `gc`, `gp`, `gl`, `gd`, `gco`, `gb`, `glog`, and more.

### Docker Plugin

```toml
[plugins]
enabled = ["docker"]
```

Provides: `d`, `dps`, `dimg`, `drun`, `dexec`, and more.

## Environment Variables

**oh-my-zsh:**
```zsh
export EDITOR="vim"
export GOPATH="$HOME/go"
```

**pzsh:**
```toml
[env]
EDITOR = "vim"
GOPATH = "$HOME/go"
```

## Startup Comparison

| Configuration | oh-my-zsh | pzsh |
|--------------|-----------|------|
| Minimal | ~200ms | <1ms |
| Git plugin | ~300ms | <1ms |
| Full config | 500-2000ms | <10ms |

## Troubleshooting

### Slow startup after migration

Check for remaining oh-my-zsh artifacts:
```bash
pzsh lint ~/.zshrc
```

Common issues:
- Leftover `source $ZSH/oh-my-zsh.sh`
- NVM without lazy loading
- Conda init blocks

### Missing aliases

Verify plugins are enabled:
```bash
pzsh compile | grep "alias g="
```

### No colors

Check terminal support:
```bash
echo $TERM
echo $COLORTERM
```

Ensure `colors = true` in config.