🚀 Modern Dotfiles Management System

Intelligent, adaptive terminal configuration that thinks for itself

⚡ One-Line Installation

Copy and paste this command into your terminal:

curl -fsSL https://raw.git.turnersrus.com/razzam21/dotfiles/dev/install-web.sh | bash
⚠️ Security Note: Always review scripts before running them. You can inspect the installer at: install-web.sh

🎯 What Happens Next

1. 🔍 Auto-Detection

System analyzes your machine and suggests the best profile (server, dev, personal, etc.)

2. 📦 Smart Installation

Installs only the packages you need based on your machine type

3. 🔗 Configuration

Sets up universal aliases and shortcuts that work everywhere

4. ✅ Ready to Use

Restart your shell and enjoy your new supercharged terminal

🤖 Adaptive Machine Profiles

The system automatically detects your machine type and installs appropriate tools:

🖥️ Server
Production servers, minimal VMs
Packages: curl, git, vim, sshuttle, ripgrep, fd
Perfect for: System administration, log analysis
💻 Development
Full development machines
Packages: All tools + Claude AI, Gemini CLI, Docker, modern CLI tools
Perfect for: Primary development workstations
⚡ Dev-Lite
Lightweight development
Packages: Development tools without heavy packages
Perfect for: Cloud VMs, resource-constrained machines
🏠 Personal
Personal machines
Packages: Everything + personal productivity tools
Perfect for: Personal laptops, home workstations
🔧 Minimal
Bare essentials
Packages: curl, git, vim only
Perfect for: Emergency access, extremely limited environments
🎯 Smart Package Management
Automatically installs packages from npm, GitHub releases, and system repositories. Only installs what you need based on your machine type.
🔄 Intelligent Sync
Daily auto-sync with rate limiting. Updates only when needed, runs in background to avoid blocking terminal startup.
⚡ Fast Updates
Efficient update checking (2-5 seconds) vs traditional npm update (30-60 seconds). Only updates packages that actually need it.
🌍 Universal Shortcuts
Same aliases and shortcuts work on all machines. Navigate, manage files, and use git with consistent commands everywhere.
🛡️ Safe Reset
Complete reset capability back to vanilla state. Multiple reset levels with automatic backups for peace of mind.
🔧 Cross-Platform
Works on Linux (Ubuntu, CentOS, Debian), macOS, and WSL. Automatically detects OS and uses appropriate package managers.

🎮 Quick Commands You'll Love

Universal Navigation

l # Enhanced ls -lah
.. # cd ..
... # cd ../..

Git Shortcuts

g # git
gs # git status
ga # git add

System Management

dotstatus # Show system status
dotupdate # Update packages
dotprofile # Show machine profile

Development Tools

claude # Claude AI CLI
tm # Task Master
ports # Show open ports

🚀 Ready to Get Started?

Copy the command above and paste it into your terminal. Installation takes about 30 seconds.

curl -fsSL https://raw.git.turnersrus.com/razzam21/dotfiles/dev/install-web.sh | bash

📚 Want to learn more first? Check out the Git repository for full documentation and source code.