shell.md

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 (via eval "$(starship init zsh)")

Module Notes

  • C module: Disabled ([c] disabled = true). The C/C++ module triggers cc/gcc/clang on .h/.c files, 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 .h file appear and probes compiler version. This looks like a mv error 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