Skip to content

FAQ

Agents spawn shells constantly and assume POSIX syntax. fish broke ( … ) && … one-liners, and zsh’s glob expansion turned URLs with ? into “no matches found” errors. Homebrew bash 5 runs everything agents write, and macOS’s own bash 3.2 is too old to be worth configuring.

Why is the prompt so small, and why no completion or history tool?

Section titled “Why is the prompt so small, and why no completion or history tool?”

The prompt is for the occasional human at a terminal: it shows the folder, how long a slow command took, and whether the last command failed. Agents get a plain folder $ prompt, and their tool shells are non-interactive, so they never load it. Atuin, zoxide, fzf, and eza were removed in October 2026 after shell and agent history showed no direct use for months.

Every ssh connection, every signed commit, and every chezmoi template that read a secret produced an approval dialog. Unattended agents cannot click it. Keys now live in ~/.ssh, Apple’s agent holds them, and the only host that still goes through 1Password is one router whose key was never exported. See Git and SSH.

In ~/.config/secrets.env, mode 600, untracked. ~/.bashrc sources it. The age-encrypted files in the repo hold only the sops key and the chezmoi key itself.

CLI tool: add a line to ~/.config/mise/config.toml, run mise install, then chezmoi re-add ~/.config/mise/config.toml. App or library: add a line to the Brewfile and run chezmoi apply.

Delete the line, then uninstall by hand (brew uninstall, mise uninstall). The bootstrap scripts only install.

Can I use the installer for my repository?

Section titled “Can I use the installer for my repository?”

Yes. See your own repository. It works for any chezmoi source repository on GitHub, GitLab, Bitbucket, or a self-hosted domain.

Because she’s cute.