Skip to content
dot
Esc
↑↓navigate↵open⌘Jpreview
On this page

Shell and terminal

zsh without a framework, the Starship prompt and Ghostty; your ~/.zshrc stays yours.

zsh (macOS’s default shell) without a framework, the Starship prompt, and Ghostty as the terminal.

dot apply packages   # installs Starship
dot apply shell      # connects ~/.zshrc to your repo

~/.zshrc stays yours

Tools such as Homebrew and 1Password ask you to append lines to ~/.zshrc, and they’re free to. dot never owns or rewrites the file: it keeps one marked block in it.

# >>> dotfiles: managed by dot apply shell
if [ -x '/Users/you/.local/share/dotfiles/live/bin/dot' ]; then eval "$('/Users/you/.local/share/dotfiles/live/bin/dot' init zsh)"; else echo 'dotfiles: no live copy at ~/.local/share/dotfiles/live; run bin/dot update in the repo' >&2; fi
# <<< dotfiles

It loads dot from the live copy, your repo at main, never from your working copy; without it, it only says so.

dot check shell lists every other line as a note, so you notice what tools added, and can move it into config/shell/ or leave it. The note shows line numbers only, never their content, because a line may hold a secret:

✓ shell init zsh
    · not from this repo: ~/.zshrc line(s) 1

What the block sets up

  1. Homebrew: PATH, MANPATH and completions.
  2. dot, as a shell function: dot clone, dot fork and dot cd take you to the folder.
  3. Completion for dot: commands, config files, settings and their values. dot apply dock visibility <Tab> offers always autohide hidden.
  4. Your files in config/shell/, in alphabetical order:
File Does
config/shell/editor.zsh EDITOR and VISUAL, from git’s core.editor (Editor)
config/shell/make.zsh make is GNU Make 4 from Homebrew, not macOS’s 3.81 (Apps and tools)
config/shell/mise.zsh the right tool versions per folder, and a uv project’s .venv (Languages and versions)
config/shell/op.zsh puts the op shim shims first on PATH, so gh and vercel get their tokens from 1Password in every process (GitHub)
config/shell/prompt.zsh Starship
config/shell/ssh.zsh SSH_AUTH_SOCK is 1Password’s SSH agent, so ssh-add -L and agent forwarding see its keys (1Password and GitHub)
config/shell/varlock.zsh Varlock completion (Secrets)

To add something to your shell, create config/shell/<topic>.zsh.

Terminal and font

Ghostty, from config/apps.conf, includes JetBrains Mono with the Nerd Font symbols Starship uses, so it needs no font setup. Other apps can use JetBrains Mono Nerd Font from config/fonts.conf.

Was this page helpful?