My Dots

Chezmoi-managed dotfiles for terminal-first development

Documentation | Quick Setup Below

Overview

Development environment built around terminal-first tools, managed with chezmoi for consistent deployment across machines. Features Claude Code integration with 19 specialized agents and 67+ command-line tools.

Quick Setup

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

# Install chezmoi and deploy dotfiles
brew install chezmoi && chezmoi init --apply https://github.com/nehalecky/dotfiles.git

This installs WezTerm with GPU acceleration, 67+ command-line tools, Claude Code with 19 specialized agents, and XDG-compliant dotfile organization.

Key Components

Core Stack

• Terminal: WezTerm (GPU-accelerated, multiplexed)
• Shell: Zsh + Starship prompt
• Editor: Helix/Emacs with LSP integration
• Package Management: Homebrew + uv (Python)

Tool Suite

Traditional	Replacement	Key Benefit
ls	eza	Git integration, tree view
cat	bat	Syntax highlighting
find	fd	Faster, respects .gitignore
grep	ripgrep	Faster searches
top	btop	Interactive system monitor

Claude Code Integration

Claude Code configuration with specialized agents and workflow automation:

• 19 specialized agents for development, research, and operations
• Memory systems for project context and methodologies
• Workflow automation via Python hooks and custom commands
• MCP integrations for GitHub, Google Workspace, Atlassian APIs
• Superpowers plugin for enhanced capabilities (October 2024)

Recent consolidation improved token efficiency by 42% (818 lines, ~65K tokens saved) through unified agent architecture.

Initial Claude Code setup based on disler/claude-code-hooks-mastery.

Documentation

Complete documentation for this development environment:

• Documentation Index - Start here for setup, tools, and architecture

Key docs:

• Setup Guide - First-time installation and customization
• Tool Reference - All 67+ tools, commands, shortcuts
• Architecture - System design and decisions

For Claude Code configuration with Superpowers integration, see CLAUDE.md.

Philosophy

Terminal-First Development:

• Consistent interface for development tasks
• Fast tool launch times
• Vim-inspired navigation patterns
• Reproducible environments via code

Dotfiles Organization:

• XDG-compliant configuration (~/.config, ~/.local)
• Chezmoi management for cross-machine deployment
• Secret integration with 1Password
• Organized home directory structure

Technology Stack

• Dotfiles Management: chezmoi
• Terminal: WezTerm + tmux/zellij
• Shell: Zsh + Prezto + Starship
• Package Managers: Homebrew (macOS), uv (Python)
• AI Integration: Claude Code + specialized agents
• Documentation: GitHub Pages (auto-deployed)

Contributing

This is a personal dotfiles repository optimized for my development workflow. While you're welcome to explore and learn from the configuration, it's designed specifically for my setup and preferences.

For questions or discussions about the approaches used, feel free to open an issue.

---

Repository: nehalecky/dotfiles • Documentation: dot_docs/README.md • License: MIT