🏠 Dotfiles

My personal configuration files, managed with GNU Stow and an automated setup script.

📦 What's Included

System Tools

Tool	Description
Zsh	Default shell
Oh My Zsh	Zsh framework
Starship	Customizable prompt
fzf	Fuzzy finder
tmux	Terminal multiplexer

Zsh Plugins

• zsh-autosuggestions — History-based suggestions
• zsh-syntax-highlighting — Syntax highlighting in the terminal
• zsh-completions — Additional completions

Dev Tools (via Mise)

Runtime / Tool	Version
Node.js	20
Python	3.12
Java	21
Poetry	latest
eza	latest
lazygit	latest
lazydocker	latest
neovim	latest

AI Tools

• Claude Code — Anthropic's coding agent

Prompt

• Starship with the Catppuccin Powerline preset (flavor Mocha)

Tip

To use a different Starship preset, edit starship/.config/starship.toml or replace it with your preferred preset:

starship preset <preset-name> -o ~/.config/starship.toml

See all available presets at starship.rs/presets.

To switch between Catppuccin flavors (Mocha, Frappé, Latte, Macchiato), change the palette line in starship.toml:

palette = 'catppuccin_frappe'

📂 Structure

dotfiles/
├── setup.sh                          # Automated setup script
├── zsh/
│   └── .zshrc                        # Zsh configuration
└── starship/
    └── .config/
        └── starship.toml             # Starship configuration

Each root directory is a Stow package. Running stow -t $HOME */ creates automatic symlinks:

• zsh/.zshrc → ~/.zshrc
• starship/.config/starship.toml → ~/.config/starship.toml

🚀 Installation

Prerequisites

• Ubuntu/Debian or Arch Linux
• A Nerd Font installed in your terminal (e.g. JetBrainsMono Nerd Font)

Setup

git clone https://github.com/deividmarreiro/dotfiles.git ~/git/dotfiles
cd ~/git/dotfiles
chmod +x setup.sh
./setup.sh

The script automatically runs the following steps:

1. Base packages — curl, git, stow, unzip, fzf, tmux, zsh
2. Zsh — Oh My Zsh + plugins
3. Dev tools — Mise + runtimes and CLIs
4. AI tools — Claude Code
5. Starship — Prompt installation
6. Dotfiles — Symlinks via Stow + sets Zsh as default shell

⚙️ Aliases

Alias	Command
c	cursor .
ll	eza -lh --icons
lg	lazygit
ld	lazydocker

📝 Notes

• The script is idempotent — it can be safely run multiple times.
• Supported distributions: Ubuntu/Debian and Arch Linux.