{"id":29576208,"url":"https://github.com/yomazini/dotfiles","last_synced_at":"2026-05-10T16:39:32.157Z","repository":{"id":301812481,"uuid":"1010371072","full_name":"yomazini/dotfiles","owner":"yomazini","description":"A modern, powerful, and beautifully crafted development environment setup featuring Vim, Tmux, and Zsh configurations optimized for productivity and aesthetics.","archived":false,"fork":false,"pushed_at":"2026-02-07T12:42:39.000Z","size":17124,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-07T21:43:39.100Z","etag":null,"topics":["nvim","tmux","tmux-conf","tmux-configs","vimrc","vimrc-configuration","zsh-theme","zshrc"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yomazini.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-28T23:33:41.000Z","updated_at":"2026-02-07T12:42:43.000Z","dependencies_parsed_at":"2025-06-29T01:37:48.478Z","dependency_job_id":"76af3e6a-b03d-49f9-8cfe-1914882e69b9","html_url":"https://github.com/yomazini/dotfiles","commit_stats":null,"previous_names":["yomazini/dotfiles"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yomazini/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yomazini%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yomazini%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yomazini%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yomazini%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yomazini","download_url":"https://codeload.github.com/yomazini/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yomazini%2Fdotfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32864082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"ssl_error","status_checked_at":"2026-05-10T13:40:02.145Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nvim","tmux","tmux-conf","tmux-configs","vimrc","vimrc-configuration","zsh-theme","zshrc"],"created_at":"2025-07-19T12:01:28.193Z","updated_at":"2026-05-10T16:39:32.146Z","avatar_url":"https://github.com/yomazini.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Ultimate Developer Dotfiles\n\n\u003e A modern, powerful, and beautifully crafted development environment setup featuring Vim, Tmux, and Zsh configurations optimized for productivity and aesthetics.\n\n - 📄 **The Visual Playbook: 10x Productivity For Software Engineers** [Get it here](https://github.com/yomazini/dotfiles/blob/main/The%20Visual%20Playbook%20Developer-Productivity-Playbook.pdf)\n - ⚡ **Read Also My Article : The Hidden Psychology of Great Developers** [Get it here](https://medium.com/@mazini/the-hidden-psychology-of-elite-developers-why-your-environment-is-everything-6d0a475e354e)\n - 🚀 The [AI-Powered Terminal Command Playbook](https://github.com/yomazini/dotfiles/blob/main/AI-Powered%20Terminal%20Command%20Playbook%20Agents.pdf)\n\n## ✨ Features\n\n### 🎨 **Beautiful Gruvbox Theme Everywhere**\n- Consistent dark theme across Vim, Tmux, and terminal\n- Eye-friendly color scheme perfect for long coding sessions\n- Carefully crafted status bars and UI elements\n\n### ⚡ **Supercharged Vim IDE**\n- **Language Support**: C/C++, Python, JavaScript, and more\n- **Smart Autocompletion** with ALE (Asynchronous Lint Engine)\n- **File Explorer** with NERDTree and icons\n- **Fuzzy Finding** with CtrlP\n- **Git Integration** with GitGutter\n- **Code Formatting** and linting\n- **Quick Commands** for common tasks\n\n### 🖥️ **Powerful Tmux Setup**\n- **Vim-like Navigation** between panes\n- **Session Management** with custom scripts\n- **Beautiful Status Bar** with system info\n- **Plugin Management** with TPM\n- **Session Persistence** (resurrect \u0026 continuum)\n- **Copy Mode** optimized for productivity\n\n### 🐚 **Modern Zsh Environment**\n- **Powerlevel10k** prompt with instant loading\n- **Oh My Zsh** with carefully selected plugins\n- **Modern CLI Tools** (eza, bat, ripgrep, fzf, zoxide)\n- **Git Workflow** enhancement functions\n- **Productivity Aliases** and functions\n- **Interactive Tools** for file management\n\n### 🔄 **Smart Rollback System**\n- **One-Command Rollback** - Restore any config file instantly with `./install.sh --rollback \u003cvim|tmux|zsh|all\u003e`\n- **Automatic Backups** - Every installation creates timestamped backups of your existing configs\n- **Safe Experimentation** - Try new configurations without fear - rollback anytime to previous working state\n- **Granular Control** - Rollback individual configs (vim, tmux, zsh) or all at once\n- **Tools Stay Intact** - Rollback only affects configuration files, all installed tools remain\n- **Backup History** - View all available backups with `./install.sh --list-backups`\n- **Safety Net** - Creates additional backup before rollback, ensuring you can never lose data\n\n### 🔧 **Advanced Command Utilities**\n- **CURL \u0026 API Testing**: Complete suite for API development and debugging\n- **JQ JSON Processing**: Parse, filter, and transform JSON with ease\n- **Essential Functions**: Universal archive extractor, backup system, instant HTTP server\n- **Interactive Help System**: Built-in terminal cheatsheet (`cheat` command)\n\n### 🤖 **AI-Powered Gemini Commands**\n- **Automate \u0026 Enhance**: Go beyond aliases with powerful, pre-configured prompts for Gemini.\n- **Expert Personas**: Generate high-quality code, documentation, summaries, and more with a single command.\n- **Streamlined Workflow**: Integrate advanced AI capabilities directly into your terminal.\n\n🚀 **The Ultimate AI-Powered Terminal Command Playbook Agents: Your A-to-Z Guide for Gemini CLI Mastery**\n\nImagine building a small to medium-sized application using only manual methods—no AI assistant, no optimized dotfiles, and no custom slash commands. Now, consider the hours spent on repetitive tasks like writing documentation, creating test cases, formatting commit messages, and building project plans from scratch.\n\n🚀 The [AI-Powered Terminal Command Playbook](https://github.com/yomazini/dotfiles/blob/main/AI-Powered%20Terminal%20Command%20Playbook%20Agents.pdf) is designed to eliminate that friction entirely. By integrating this suite of custom agents directly into your terminal, you can automate these workflows, with each tool acting like a **second brain** that understands the specific context of your project's data, not just vague instructions.\n\nThis approach saves a minimum of five hours on any given project and boosts your productivity tenfold, all while delivering a more consistent and professional result.\n\n## 🛠️ What's Included\n\n### 📁 Configuration Files\n- **`.vimrc`** - Complete Vim IDE setup\n- **`.tmux.conf`** - Feature-rich Tmux configuration  \n- **`.zshrc`** - Modern shell environment with productivity tools\n\n### 🔧 Essential Tools\n```\nDevelopment Tools:\n├── autopep8          # Python code formatter\n├── clangd           # C/C++ language server\n├── pylsp            # Python language server\n└── pycodestyle      # Python style checker\n\nFile \u0026 Navigation:\n├── bat              # Modern cat with syntax highlighting\n├── eza              # Modern ls replacement\n├── fd               # Modern find replacement\n├── rg (ripgrep)     # Ultra-fast grep replacement\n├── fzf              # Fuzzy finder\n├── zoxide           # Smart cd replacement\n└── ranger           # Terminal file manager\n\nSystem \u0026 Productivity:\n├── glow             # Markdown viewer\n├── procs            # Modern ps replacement\n├── dust             # Disk usage analyzer\n├── btop             # System monitor\n├── termdown         # Terminal countdown timer\n├── tldr             # Simplified man pages\n├── todo.sh          # Command-line todo manager\n└── jq               # JSON processor\n\nDevelopment Utilities:\n├── entr             # File watcher\n├── ipcalc           # IP calculator\n├── mc               # Midnight Commander\n└── curl             # Data transfer tool\n```\n\n## 🚀 Quick Start\n\n### 1️⃣ **One-Line Installation**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/yomazini/dotfiles/main/install.sh -o install.sh \u0026\u0026 chmod +x install.sh \u0026\u0026 ./install.sh\n```\n\n### 2️⃣ **Manual Installation**\n```bash\n# Clone the repository\ngit clone https://github.com/yomazini/dotfiles.git\ncd dotfiles\n\n# Run the installation script\nchmod +x install.sh\n./install.sh\n```\n\n### 3️⃣ **What the installer does:**\n- 🔄 Backs up your existing configurations\n- 📦 Installs all required tools and dependencies\n- 🔗 Creates symbolic links to the new configurations\n- 🎨 Sets up plugins and themes\n- 🤖 Installs Gemini AI commands (optional)\n- 💻 Sets up interactive help system\n- ✅ Verifies the installation\n\n## 📖 Usage Guide\n\n### 🎯 **Vim IDE Commands**\n\n| Command | Description |\n|---------|-------------|\n| `\u003cSpace\u003ew` | Save file |\n| `\u003cSpace\u003eq` | Quit |\n| `\u003cSpace\u003ewq` | Save and quit |\n| `\u003cSpace\u003ej` | Format JSON |\n| `\u003cSpace\u003ed` | Show error details |\n| `Ctrl+n` | Toggle file tree |\n| `Ctrl+p` | Fuzzy file search |\n| `:Format` | Auto-format code |\n| `:GStatus` | Git status in split |\n\n### 🖥️ **Tmux Power User Commands**\n\n| Command | Description |\n|---------|-------------|\n| `Ctrl+a` | Prefix key |\n| `Ctrl+a r` | Reload config |\n| `Ctrl+a e` | Edit config |\n| `Ctrl+a \"` | Horizontal split |\n| `Ctrl+a %` | Vertical split |\n| `Ctrl+a hjkl` | Navigate panes |\n| `Ctrl+a HJKL` | Resize panes |\n| `Ctrl+a j` | Session switcher |\n| `Ctrl+a z` | Zoom pane (fullscreen) |\n\n### 🐚 **Zsh Productivity Shortcuts**\n\n#### CURL \u0026 API Testing\n```bash\ncgetjson \u003curl\u003e              # GET JSON with pretty print\ncpost \u003curl\u003e \u003cdata\u003e          # POST JSON data\ncput \u003curl\u003e \u003cdata\u003e           # PUT JSON data\ncdel \u003curl\u003e                  # DELETE request\nchead \u003curl\u003e                 # Fetch headers only\ncresolve \u003cdomain\u003e \u003cip\u003e \u003curl\u003e # Test DNS override\n```\n\n#### JQ JSON Processing\n```bash\n... | jval \u003ckey\u003e            # Extract single value\n... | jfield \u003ckey\u003e          # Extract field from array\n... | jfields \u003ck1\u003e \u003ck2\u003e     # Extract multiple fields as table\n... | jfind \u003ckey\u003e \u003cvalue\u003e   # Filter by exact match\n... | jfind \u003ckey\u003e \u003cval\u003e -c  # Filter by contains (partial)\n```\n\n#### Essential Functions\n```bash\nextract \u003carchive\u003e           # Universal archive extractor\ngitignore \u003clanguage\u003e        # Generate .gitignore file\nbackup \u003cfile/dir\u003e           # Create timestamped backup\nserve [port]                # Start HTTP server (default: 8000)\npfind                       # Interactive process finder/killer\ncat_exts [.ext ...]         # Cat all files by extension\n```\n\n#### Git Workflow\n```bash\ngia        # Interactive git add with preview\ngco        # Interactive branch checkout\nglo        # Beautiful git log with fzf\ngs         # Git status\ngd         # Git diff\ngundo      # Undo last commit (keep changes)\ngwip       # Quick WIP commit\ngclean     # Delete merged branches\n```\n\n#### File Operations\n```bash\nvf         # Find and edit file with fzf\ncf         # Find and view file with fzf\nfgr        # Find in files and open in editor\nfer        # Find recent files (last 24h)\ndel        # Interactive file deletion\nmkcd dir   # Create and enter directory\n```\n\n#### Modern CLI\n```bash\nll         # Detailed file listing with icons\ntree       # Directory tree view\ncat file   # Syntax highlighted file view\ngrep text  # Fast search with ripgrep\ncd dir     # Smart directory jumping with zoxide\n```\n\n#### System \u0026 Productivity\n```bash\ntodo       # Find TODO/FIXME in code\nport 3000  # Check what's using a port\nweather    # Get weather forecast\ncpy file   # Copy to clipboard\nmyip       # Get your public IP\nbigstuff   # Show large directories and files\nbtop       # System monitor dashboard\npfind      # Interactive process manager\n```\n\n### 📚 **Interactive Help System**\n\nAccess the built-in terminal cheatsheet anytime:\n\n```bash\ncheat              # Interactive menu with all categories\ncheat curl         # Jump directly to CURL commands\ncheat git          # Jump directly to Git workflow\ncheat search       # Search all commands (with FZF)\nch                 # Short alias for 'cheat'\nchelp \u003ccommand\u003e    # Get help for specific command\n\n# Examples:\nchelp cgetjson     # Quick help for cgetjson\nchelp jfind        # Quick help for jfind\ncheat tmux         # Show all TMUX commands\n```\n\n**Available categories:**\n- `curl` - CURL \u0026 API Testing\n- `jq` - JQ JSON Processing\n- `essential` - Essential Functions\n- `tmux` - TMUX Commands\n- `vim` - VIM Commands\n- `git` - Git Workflow\n- `files` - File Operations\n- `system` - System Monitoring\n- `docker` - Docker Utilities\n- `search` - Search All Commands\n\n### 🤖 Gemini Commands\n\nThese custom commands are designed to integrate the power of Google's Gemini directly into your command-line workflow, turning simple prompts into powerful, structured outputs. By using expert personas and predefined templates, they streamline common tasks, automate complex processes, and ensure high-quality, consistent results for everything from writing code to summarizing meetings.\n\nThe following custom commands are included to supercharge your workflow with Gemini. They are automatically installed into `~/.gemini/commands`.\n\n| Command Category | Command Name | Description |\n| :--- | :--- | :--- |\n| **Content** | `content-summarize` | Provides a multi-format summary of any text. |\n| | `email-draft` | Drafts professional emails based on context, tone, and purpose. |\n| | `meeting-summary` | Summarizes meeting notes into actionable insights. |\n| | `prompt-enhance` | Refines a raw user prompt into a highly effective instruction. |\n| | `report-gen` | Generates comprehensive reports from data files. |\n| **Development** | `code-refactor` | Refactors a piece of code based on a specific instruction. |\n| | `debug-assistant` | Analyzes error logs and provides systematic debugging strategies. |\n| | `doc-generate` | Generates professional, language-aware documentation for code. |\n| | `docker-explain` | Explains a Dockerfile or docker-compose.yml in plain English. |\n| | `git-commit` | Generates a Conventional Commit message from staged changes. |\n| | `git-summarize` | Summarizes a git log into a human-readable changelog. |\n| | `test-create` | Generates a complete, runnable test file for the provided code. |\n| | `test-gen` | Automatically generates comprehensive test cases. |\n| | `test-report` | Analyzes a test failure report and suggests fixes. |\n| **Media** | `photo-rename` | Organizes and renames photos based on visual content and metadata. |\n| **Productivity**| `flashcards-create` | Generates a set of 10 technical flashcards for Anki. |\n| | `local-weather` | Provides a clean, natural-language summary of the weather. |\n| | `search-advanced` | Activates an advanced search agent for up-to-date information. |\n| | `task-prioritizer` | Creates organized, actionable task lists with time estimates. |\n| | `ticket-create` | Formats a simple description into a structured bug report or ticket. |\n| **Security** | `security-audit` | Performs a comprehensive security audit of code and dependencies. |\n| **System** | `apt-find` | Searches APT repositories using natural language. |\n| | `cleanup` | Identifies and suggests cleanup opportunities in a codebase. |\n| | `file-organizer` | Intelligently organizes files in directories. |\n| | `sys-health-check` | Provides a quick summary of system health (disk, memory, CPU). |\n| | `sys-search` | Translates a natural language query into a ripgrep command. |\n\n## 🎨 Customization\n\n### 🎭 **Changing Themes**\nAll configurations use the **Gruvbox** theme for consistency. To change:\n\n**Vim**: Edit `.vimrc` and change `colorscheme gruvbox`\n```vim\ncolorscheme your-theme-name\n```\n\n**Tmux**: Edit the color variables in `.tmux.conf`\n```bash\nbg1='#your-bg-color'\nfg='#your-fg-color'\nyellow='#your-accent-color'\n```\n\n### ⌨️ **Custom Key Bindings**\nAdd your own shortcuts to `.vimrc`:\n```vim\nnnoremap \u003cleader\u003eyour-key :YourCommand\u003cCR\u003e\n```\n\nOr to `.tmux.conf`:\n```bash\nbind your-key your-command\n```\n\n### 🔧 **Adding Tools**\nTo add new CLI tools, edit `install.sh` and `.zshrc`:\n\n1. Add installation command to `install.sh`\n2. Add aliases/functions to `.zshrc`\n3. Re-run the installer\n\n## 🔧 Troubleshooting\n\n### Common Issues\n\n**🐍 Python Tools Not Working?**\n```bash\n# Ensure Python and pip are installed\npython3 --version\npip3 --version\n\n# Reinstall Python tools\npip3 install --user autopep8 python-lsp-server pycodestyle\n```\n\n**🎨 Colors Not Showing?**\n```bash\n# Check terminal color support\necho $TERM\n# Should show: screen-256color or xterm-256color\n\n# Test colors\ncurl -s https://gist.githubusercontent.com/HaleTom/89ffe32783f89f403bba96bd7bcd1263/raw/ | bash\n```\n\n**🔌 Vim Plugins Failing?**\n```bash\n# Reinstall vim-plug\ncurl -fLo ~/.vim/autoload/plug.vim --create-dirs \\\n    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim\n\n# Reinstall plugins\nvim +PlugInstall +qall\n```\n\n**📦 Tmux Plugins Not Loading?**\n```bash\n# Install TPM\ngit clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm\n\n# Install plugins: Ctrl+a + I\n```\n\n**❓ Help System Not Working?**\n```bash\n# Ensure functions are loaded\nsource ~/.zshrc\n\n# Test the help system\ncheat\n\n# If FZF not working in search\n# Install FZF: git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf \u0026\u0026 ~/.fzf/install\n```\n\n### 🩺 Health Check\nRun this to verify your setup:\n```bash\n# Check essential tools\nfor tool in vim tmux zsh git fzf rg bat eza fd zoxide jq curl; do\n    command -v $tool \u003e/dev/null 2\u003e\u00261 \u0026\u0026 echo \"✅ $tool\" || echo \"❌ $tool\"\ndone\n\n# Test custom functions\ntype cgetjson \u003e/dev/null 2\u003e\u00261 \u0026\u0026 echo \"✅ CURL functions loaded\" || echo \"❌ CURL functions missing\"\ntype jfind \u003e/dev/null 2\u003e\u00261 \u0026\u0026 echo \"✅ JQ functions loaded\" || echo \"❌ JQ functions missing\"\ntype cheat \u003e/dev/null 2\u003e\u00261 \u0026\u0026 echo \"✅ Help system loaded\" || echo \"❌ Help system missing\"\n```\n\n## 📊 Productivity Metrics\n\n**Time saved per day:** 45-60 minutes  \n**Weekly savings:** 5-7 hours  \n**Monthly savings:** 20-28 hours\n\n### Impact on Development\n- **Commands saved**: ~200 keystrokes/day\n- **Context switches**: Reduced by 60%\n- **Setup time**: From 1 hour to 5 minutes\n- **Testing time**: Reduced by 70%\n- **Debugging time**: Reduced by 50%\n\n## NOTE: \nYou may encounter some Problems in the install.sh. simply remove these lines from the script and do it manually\n```bash \n\n     print_step \"Installinsg Zsh plugins...\"\n     \n     # zsh-autosuggestions\n-    if [ ! -d \"${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions\" ]; then\n-        git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions\n-    else\n-        print_success \"zsh-autosuggestions already installed\"\n-    fi\n-    \n-    # zsh-syntax-highlighting\n-    if [ ! -d \"${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting\" ]; then\n-        git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting\n-    else\n-        print_success \"zsh-syntax-highlighting already installed\"\n-    fi\n     \n     print_success \"Zsh plugins installed\"\n\n\n```\n\n## 🤝 Contributing\n\nFound a bug or have a suggestion? Contributions are welcome!\n\n1. **Fork** the repository\n2. **Create** a feature branch: `git checkout -b amazing-feature`\n3. **Commit** your changes: `git commit -m 'Add amazing feature'`\n4. **Push** to the branch: `git push origin amazing-feature`\n5. **Open** a Pull Request\n\n## 🙏 Acknowledgments\n\n- **Oh My Zsh** community for the amazing framework\n- **Vim** and **Tmux** communities for the incredible tools\n- **1337 / 42 School** for the inspiration and learning environment\n\n## 🎭 Author\n\nMade with ☕️☕️☕️ by **Youssef Mazini** (ymazini)\n\n\n- 🐙 GitHub: [yomazini](https://github.com/yomazini)\n- 💼 LinkedIn: [Connect with me](https://www.linkedin.com/in/youssef-mazini/)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ Star this repo if it helped you! ⭐**\n\n*Built for developers, by developers* 🚀\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyomazini%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyomazini%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyomazini%2Fdotfiles/lists"}