🛡️
Safety First
Non-destructive development with comprehensive backup/restore system and easy rollback capabilities.
DotClaudeModern Dotfiles for AI Development
A highly modular CLI setup optimized for Claude Code and agentic development workflows
Skip to content
Quick Start
bash
# Clone the repository
git clone git@github.com:kormie/dotclaude.git ~/.dotfiles
cd ~/.dotfiles
# Install modern tools (safe, non-destructive)
./scripts/setup-tools.sh
# Launch Claude Code workspace
cw myproject feature-1 feature-2 # 'cw' alias for tmux-claude-workspace
# Apply configurations gradually
./scripts/stow-package.sh git # Enhanced git config
./scripts/stow-package.sh tmux # Vim-optimized tmux
./scripts/stow-package.sh aliases # Centralized aliasesPhase 1 Complete ✅
Foundation & Safety Infrastructure
- Comprehensive backup/restore system tested and working
- Multi-session Claude Code workspace with git worktrees
- Vim-optimized tmux configuration with seamless navigation
- Enhanced git configuration with modern diff tools
- Modern CLI tool installation with coexisting aliases
View detailed Phase 1 documentation →
Phase 2 Complete ✅
Shell Enhancement
- Enhanced Zsh configuration with Oh-My-Zsh and essential plugins
- Modern tool migration: tools now default with automatic fallbacks
- Safety toggle system for easy configuration switching
- Centralized alias management with single source of truth
View detailed Phase 2 documentation →
Phase 3 Complete ✅
Editor Enhancement
- Modern Neovim configuration with Lua and lazy.nvim (40+ plugins)
- Full LSP integration with Mason for automatic language servers
- Advanced git integration (gitsigns, fugitive, diffview)
- Enhanced UI with Tokyo Night theme, Lualine, Neo-tree explorer
- Telescope integration for fuzzy finding files, text, git, LSP
- All user preferences preserved (comma leader, hjkl navigation)
- Production ready with comprehensive testing and issue resolution
View Phase 3 migration guide →
✅ Phase 4 Complete - Full Integration & Optimization
All Project Goals Achieved:
- ✅ Enhanced configurations deployed as primary setup
- ✅ Performance optimized: Neovim ~47ms, Zsh ~380ms startup
- ✅ Advanced shell features: project environments, command correction
- ✅ Modern tool migration complete: eza, bat, fd, ripgrep, zoxide, dust, procs, bottom now defaults
- ✅ Smart navigation: cd now uses zoxide for transparent smart directory jumping
- ✅ Automatic fallbacks: Legacy tools available with _original suffix
- ✅ Comprehensive testing and validation complete
- ✅ Production-ready with complete safety systems
DotClaude is now fully operational - a modern, safe, and powerful CLI environment optimized for AI-assisted development!
View complete project documentation →
Why DotClaude?
Built specifically for developers using Claude Code and other AI tools, DotClaude provides:
- Parallel Development: Work on multiple features simultaneously with git worktrees
- Vim Integration: Seamless navigation between vim and tmux with consistent keybindings
- Safety Systems: Comprehensive backup and rollback procedures for peace of mind
- Modern Tools: Latest Rust-based CLI tools now as defaults with automatic fallbacks
- AI-Optimized Workflows: Purpose-built for agentic development patterns
Perfect for developers who want a powerful, safe, and modern CLI environment optimized for AI-assisted development workflows.
🎉 Mission Accomplished
DotClaude project is complete! From initial concept to production deployment, this project successfully delivered a modern, safe, and powerful CLI environment specifically optimized for AI-assisted development.
Ready to transform your development workflow? Get started now →
Built for the future of AI-assisted development 🤖✨