Dotfiles com Chezmoi e Fish
toshiki670/dotfiles
Dotfiles multiplataforma com Fish, Neovim e utilitários CLI unificados
Ver no GitHubRepositório de configurações de desenvolvimento que unifica ambientes em múltiplas plataformas usando chezmoi como gerenciador. Inclui shell Fish com Starship, Neovim, Git com delta, mise para versionamento de runtimes e diversos utilitários CLI modernos (eza, bat, fd, ripgrep, zoxide, fzf).
Instalação
npx convez-ai toshiki670/dotfiles1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Sincronizar configurações de desenvolvimento entre múltiplos computadores
- Configurar ambiente local com shell Fish otimizado e ferramentas modernas
- Centralizar e versionizar settings de editor, terminal e CLI tools
Veredito

Dotfiles bem estruturado e maduro para quem quer automatizar setup de ambiente development. Usa ferramentas modernas (Fish, Starship, Neovim) e chezmoi para replicação cross-platform; requer familiaridade com CLI para aproveitar.
README
A tradução para o português deste README ainda está na fila.
Overview
- Simplification of environment construction
- Unification of environment across multiple platforms
This repository is managed with chezmoi. Fish is the shell (~/.config/fish/conf.d/), with Starship as the interactive prompt. Also included: Neovim, Git (split config + delta), mise, optional Ghostty / Zellij configs, and scripts under bin/.
Prerequisites
Required Tools
These cover the Fish-first workflow and shared tooling (Git, editor, mise, CLI utilities).
brew install git gh fish nvim mise eza bat fd ripgrep starship zoxide fzf git-delta
Required Homebrew tool descriptions
git- Version control systemgh- GitHub CLI (used by shell prompts and aliases)fish- Fish shell (primary shell for this dotfiles set)nvim- Neovim text editormise- Runtime version managereza- Modern replacement for lsbat- Modern replacement for cat with syntax highlightingfd- Fast and user-friendly alternative to findripgrep- Fast search tool (rg command)starship- Minimal, fast prompt (starship.rs); Fish loads it fromconfig.fish, config at~/.config/starship.tomlzoxide- Smarter cd command that learns your habitsfzf- Command-line fuzzy finder (used with zoxide and Fish key bindings)git-delta- Syntax-highlighting pager for git, diff, and grep output
Optional Tools
brew install ffmpeg marp-cli gitui ghostty zellij smartmontools rtk
Optional Homebrew tool descriptions
ffmpeg- Multimedia framework (required for video/audio processing)marp-cli- Markdown to PDF/PowerPoint convertergitui- Terminal UI for git commandsghostty- Terminal emulator; config lives under~/.config/ghostty/(see Configuration)zellij- Terminal multiplexer; config under~/.config/zellij/smartmontools- S.M.A.R.T. disk health monitoring (smartctl)rtk- CLI proxy that reduces LLM token usage by 60–90% (rtk-ai/rtk); after install, runrtk init -gto configure Claude Code hooks
After installing rtk, initialize the Claude Code hook:
rtk init -g
Installation
Using chezmoi (Recommended)
1. Install chezmoi
brew install chezmoi
2. Initialize with this repository
chezmoi init --ssh toshiki670
3. Preview changes (optional)
chezmoi diff
4. Apply the dotfiles
chezmoi apply
5. Restart Shell
exec fish -l
6. Set login shell (recommended for Fish)
chsh -s "$(which fish)"
Configuration
Shell (Fish)
Modular config under ~/.config/fish/conf.d/. Interactive sessions run starship init fish from config.fish; prompt styling lives in ~/.config/starship.toml.
Environment Variables (Using Mise)
Create global configuration file: ~/.config/mise/config.toml
[env]
# yt-dlp browser selection
# Options: "chrome:Default", "chrome:Profile 1", "firefox", "safari", "edge"
YT_BROWSER = "chrome:Default"
Note: To check your Chrome profile name, visit chrome://version/ and look for the "Profile Path".
Apply changes:
exec $SHELL -l
Ghostty (macOS)
On macOS, chezmoi apply runs a hook that symlinks Ghostty’s expected config path to ~/.config/ghostty/config. If you use Ghostty, install it separately (see Optional Tools). Ghostty works well as the terminal for a Fish-centric setup.
Platform-Specific Notes
macOS
- Homebrew configurations will be applied automatically
- Custom binaries in
bin/will be added to PATH - Ghostty config symlink is set up as described above
Development
See CONTRIBUTING.md for lint, test, and release instructions. To trigger a release directly: Run Release Workflow.