shell.md
Table of Contents
Shell Setup
Shell
- Shell: Zsh (
/bin/zsh) - Terminal: macOS Terminal / iTerm2 (TBD)
Prompt: Starship
- Version: 1.25.1
- Installed via: Homebrew (
/opt/homebrew/bin/starship) - Config:
~/.config/starship.toml - Init:
~/.zshrc(viaeval "$(starship init zsh)")
Module Notes
- C module: Disabled (
[c] disabled = true). The C/C++ module triggerscc/gcc/clangon.h/.cfiles, which can hang/time out if compiler tools aren't responsive. Easier to disable than troubleshoot. - command_timeout: Default 500ms. If modules start timing out, bump this in config.
Common Gotchas
mv foo.sh foo.h→ Starship sees the.hfile appear and probes compiler version. This looks like amverror but isn't — the file moved fine, Starship just timed out in the prompt.
Config Files
| File | Purpose |
|---|---|
~/.zshrc |
Zsh startup, Starship init |
~/.zprofile |
Zsh login profile |
~/.bashrc |
Bash RC (legacy, from pre-Zsh?) |
~/.config/starship.toml |
Starship prompt config |