helderberto/dotfiles

helderberto/dotfiles has 116 GitHub stars and 29 forks. Star changes are not measured yet. Last checked 2026-11-14 00:36 UTC. Last push 2026-10-28.

Comment ces chiffres sont mesurés

116 étoiles 29 Forks

Progression mesurée des étoiles

in 24h: Historique en cours
in 7 days: Historique en cours
in 15 days: Historique en cours
in 1 month: Historique en cours

Variations nettes sur des périodes qui se chevauchent, pas des totaux quotidiens. Les mesures absentes restent vides. Les étoiles indiquent l’intérêt, pas la qualité.

À propos

⚙️ Setup a macOS environment quickly and easily!

Outils de développement

README.md

Original

Helder's Dotfiles

macOS dotfiles managed with chezmoi

Already using these? chezmoi update

New Mac → New Mac. Mac already in use → Existing Mac.

What you get

Area	Result
Packages	All of `Brewfile`: CLI tools, apps, fonts, App Store apps
Ghostty	Catppuccin Mocha, JetBrainsMono Nerd Font, split keybinds
Shell	zsh, Powerlevel10k prompt, autosuggestions, syntax highlighting, fzf, z, Opt+Backspace deletes word
tmux	Config, plugins install on apply
Neovim	Full config, plugins install on first launch
Git	Config, aliases, global ignore, commit template
Runtimes	asdf versions from `.tool-versions`
Claude Code	Native install, `CLAUDE.md`, rules, statusline script
macOS	Dock, key repeat, Caps Lock → Left Ctrl, scrolling, Finder, no `.DS_Store` on shares, `~/workspace/labs`, SSH key

New Mac

1. Before leaving the old Mac

Check that the repo has everything:

chezmoi status                                   # managed files edited outside the repo → chezmoi re-add
brew bundle cleanup --file ~/.dotfiles/Brewfile  # installed but not in Brewfile → add or ignore

Never pass --force to cleanup. It uninstalls everything unlisted, including Apple's apps.

Save these to 1Password:

Raycast settings: Settings → Advanced → Export (.rayconfig file)
~/.private
~/.claude/settings.json (Claude Code permissions, plugins, statusline)
Shottr license key

2. Install

First, open the App Store and sign in. App Store apps fail to install without it.

Then open Terminal and run each command one at a time. Wait for each to finish. Pasting them together breaks the Homebrew installer, which reads your password and an Enter keypress.

Install Homebrew. It also installs the Xcode Command Line Tools.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Load Homebrew in this Terminal session.

eval "$(/opt/homebrew/bin/brew shellenv)"

Install chezmoi.
```
brew install chezmoi
```
Clone this repo to ~/.dotfiles and apply everything. Existing dotfiles in ~ get overwritten.
```
chezmoi init --apply --source ~/.dotfiles helderberto
```
This takes a while. It stops to ask for your password (some apps need it) and an email for the new SSH key.

3. Finish in Ghostty

Restore ~/.private from 1Password. Then close Terminal and open Ghostty. Your shell config loads from here on.

Add your SSH key to GitHub. Git pushes to GitHub over SSH.

pbcopy < ~/.ssh/id_ed25519.pub   # paste at https://github.com/settings/ssh/new
ssh -T [email protected]            # answer "yes" to trust GitHub

4. Set up apps

These need a login or a manual step:

App	Step
Raycast	Turn off Spotlight's `⌘ Space` (System Settings → Keyboard → Keyboard Shortcuts → Spotlight). Import the `.rayconfig`
Shottr	Allow Screen Recording. Enter the license key
VSCode	Turn on Settings Sync. It restores settings and extensions
Claude, Chrome, Todoist, Slack, Obsidian, Spotify, 1Password	Sign in

Claude Code:

Run claude and log in.
Restore ~/.claude/settings.json from 1Password.
Run /plugin marketplace add helderberto/agent-skills.

Work tools stay out of this repo. Set them up on the work Mac.

Existing Mac

Adds what's missing. Preview first: ~ may hold edits you want to keep.

Clone without applying. Needs Homebrew.

brew install chezmoi
chezmoi init --source ~/.dotfiles helderberto

Preview changes to ~. Move machine-only bits to ~/.private before applying.
```
chezmoi diff
```
Sign in to the App Store, then apply. brew bundle installs only what's missing.
```
chezmoi apply
```
Do steps 3 and 4 for anything not set up yet.

Day-to-day usage

Making updates

Edit in ~/.dotfiles, then apply and push:

chezmoi apply
git add <file> && git commit -m "..." && git push

New app or CLI tool → add it to Brewfile
New runtime version → edit dot_tool-versions
App rewrote a managed file (p10k configure) → chezmoi re-add

chezmoi apply reruns brew bundle, asdf install, or the tmux plugin install when those files change.

Machine-specific config

~/.private is not managed. Put machine-only env vars and secrets there. The shell sources it.

export WORK_API_KEY=...
alias workspace="cd ~/my-company/workspace"

Chezmoi reference

Command	Purpose
`chezmoi update`	Pull the repo and apply
`chezmoi re-add`	Copy edits made in `~` back to the repo
`chezmoi status`	Show drift between `~` and the repo
`chezmoi diff`	Preview changes
`chezmoi apply`	Apply dotfiles to `~`
`chezmoi managed`	List managed paths

Development

./test-chezmoi.sh              # syntax & config checks
./test-chezmoi.sh --post-apply # also validates installed tools

CI runs the suite on every push and PR.

AGENTS.md holds the agent instructions. ~/.claude/CLAUDE.md imports it. Skills live in helderberto/agent-skills.