Settings
Every setting dot knows, with its values; dot explain prints the same list from the code.
Every setting is one <topic> <setting> <value> line in a file in config/.
Change the value there, or delete the line to leave that setting alone. A
file can mix topics (config/windows.conf holds hammerspoon … and
windows … lines). dot explain prints this list from the code, with where
config/ uses each one.
| Topic | Setting | Values |
|---|---|---|
aws |
aliases |
linked: symlink to config/home/.aws/cli/alias (aws whoami) |
aws |
sso |
profiles in ~/.aws/config for IAM Identity Center; from $aws.* (AWS) |
brew |
formula |
a Homebrew formula (command-line tool), e.g. gh |
brew |
cask |
a Homebrew cask (app, font or binary), e.g. 1password |
brew |
tap |
owner/repo: a third-party package source, trusted explicitly |
claude |
hook |
<event> <matcher> <script>: a Claude Code hook from config/home/.claude/hooks/, added to ~/.claude/settings.json (Agents) |
containers |
runtime |
docker-desktop, orbstack, rancher, colima: what runs docker (Apps and tools) |
dock |
visibility |
always, autohide, hidden |
editor |
default |
zed, code, cursor, nvim, vim, nano; from $editor |
git |
name |
any text; from $git.name |
git |
email |
an email address; from $git.email |
git |
signing-key |
title of an SSH key in 1Password; from $ssh_key |
git |
identity |
<dir> <name> <email>: name and email for repos under <dir> |
git |
identities |
one git identity per table; from $git.identity.* (Git and signing) |
gh |
extension |
owner/gh-name: a GitHub CLI extension, e.g. github/gh-stack (Apps and tools) |
github |
ssh-key |
<user> <title>: an SSH key in 1Password, added to your account for authentication and signing; from $github.user $ssh_key |
hammerspoon |
config |
linked: symlinks to config/home/.hammerspoon/ (init.lua and the automations it loads) |
hammerspoon |
tile |
<combo> <from>-<to>, e.g. cmd+opt+left 0-25: the shortcut puts the window in that range of the screen’s width, in percent (Windows) |
keyboard |
repeat-rate |
integer; lower is faster (System Settings stops at 2) |
keyboard |
repeat-delay |
integer; lower is shorter (System Settings stops at 15) |
keyboard |
press-and-hold |
true (holding a letter shows its accents), false (it repeats) |
mise |
config |
linked: symlink to config/home/.config/mise/config.toml |
mise |
tools |
installed: every tool in the global mise config |
mouse |
speed |
0.0–3.0 |
mouse |
secondary-click |
right, left, off |
mouse |
natural-scrolling |
true, false; macOS applies it to the trackpad too |
screenshot |
save-to |
clipboard, desktop (macOS default), preview: where ⌘⇧3 and ⌘⇧4 send it |
op |
shim |
gh, vercel: every process runs it through 1Password’s shell plugin |
op |
agent-token |
gh $github.*: agents, and processes without a terminal, use the token under github.agent_tokens for the repo’s owner (personal: yours, with 1Password’s approval on each call), or github.agent_token, instead of your token |
shell |
live |
main: the live copy at ~/.local/share/dotfiles/live is at origin’s main (dot update moves it) |
shell |
init |
zsh: the managed block in ~/.zshrc, loading dot from the live copy |
ssh |
agent |
1password |
system |
hostname |
letters, digits, hyphens; sets all three macOS names (sudo) |
system |
font-smoothing |
on (macOS default), off: thinner text, most noticeable on Retina displays |
varlock |
telemetry |
enable, disable: Varlock’s usage analytics; from $varlock.telemetry |
trackpad |
speed |
0.0–3.0 |
trackpad |
tap-to-click |
true, false |
trackpad |
three-finger-drag |
true, false; moves three-finger swipes to four fingers |
windows |
native-tiling |
true, false: macOS’s own edge tiling |
zed |
settings |
linked: symlink to config/home/.config/zed/settings.json |
$… values come from dot.toml (Your values).