php-guidelines-from-spatie

• Custom Agnoster Theme - Clean powerline prompt with no branch symbols, • for changes
• Version-Controlled Skills & Agents - All Claude Code skills and agents synced via dotfiles
• Fast Tools - fnm, zoxide, ripgrep, bat, eza (all Rust-based for speed)
• Nerd Fonts - Installed automatically via Brewfile for perfect icon support
• One Command Install - bin/install sets up everything including Claude Code

---

```bash

git clone git@github.com:freekmurze/dotfiles.git ~/.dotfiles

cd ~/.dotfiles

bin/install

```

---

Shell & Prompt

• Oh My Zsh - Framework for managing Zsh configuration (with agnoster theme by default)
• zoxide - Smart directory jumping based on frecency
• fzf - Fuzzy finder for files and history
• direnv - Automatic environment variables per directory

Modern CLI Tools

• fnm - Fast Node.js version manager
• bat - Cat with syntax highlighting
• eza - Modern ls replacement with icons
• ripgrep - Fast grep alternative
• fd - Fast find alternative
• git-delta - Better git diffs
• jq - JSON processor and formatter
• yq - YAML processor and formatter
• bottom - Modern system monitor

Development Tools

• PHP - Latest version via Homebrew
• Composer - Dependency manager via Homebrew
• Node.js - LTS version managed via fnm
• Laravel Valet - Local development server
• MySQL - Database with auto-start

QuickLook Plugins

Instant file previews in Finder: code files, markdown, JSON, CSV, patches, and archives.

---

Symlinked Files

The installation creates symlinks from your home directory to the dotfiles repository. This allows you to version control your configuration while keeping files in their expected locations.

| Symlink Location | Points To | Purpose |

|-----------------|-----------|---------|

| ~/.zshrc | ~/.dotfiles/home/.zshrc | Main Zsh configuration (Oh My Zsh with custom agnoster theme) |

| ~/.gitconfig | ~/.dotfiles/home/.gitconfig | Git configuration with delta diff viewer |

| ~/.global-gitignore | ~/.dotfiles/home/.global-gitignore | Global Git ignore patterns |

| ~/.vimrc | ~/.dotfiles/home/.vimrc | Vim configuration |

| ~/.vim/ | ~/.dotfiles/home/.vim/ | Vim runtime files |

| ~/.mackup.cfg | ~/.dotfiles/macos/.mackup.cfg | Mackup backup configuration |

| ~/.claude/skills | ~/.dotfiles/config/claude/skills/ | All Claude Code skills (version-controlled) |

| ~/.claude/agents | ~/.dotfiles/config/claude/agents/ | All Claude Code agents (version-controlled) |

| ~/.claude/CLAUDE.md | ~/.dotfiles/config/claude/CLAUDE.md | Claude Code configuration |

| ~/.claude/laravel-php-guidelines.md | ~/.dotfiles/config/claude/laravel-php-guidelines.md | Laravel coding standards |

| ~/.claude/settings.json | ~/.dotfiles/config/claude/settings.json | Claude Code settings |

Sourced Files

These files are loaded by .zshrc but remain in the dotfiles directory:

• home/.aliases - Shell command aliases
• home/.functions - Custom shell functions
• home/.exports - Environment variables

Custom Agnoster Theme

The default configuration uses a customized agnoster theme stored in oh-my-zsh-custom/themes/agnoster.zsh-theme:

Customizations:

• No git branch symbol (cleaner look)
• Uses • for unstaged changes instead of ±
• Powerline arrows for segment separators
• Requires Nerd Font with powerline glyphs

Git Status Symbols:

• ✚ - Staged changes (files added with git add)
• • - Unstaged changes (modified files not yet staged)
• Yellow background - Uncommitted changes
• Green background - Clean working directory

---

Smart Navigation

```bash

z