{"id":22371293,"url":"https://github.com/zerebos/dotfiles","last_synced_at":"2026-04-13T23:31:43.752Z","repository":{"id":265026857,"uuid":"876939181","full_name":"zerebos/dotfiles","owner":"zerebos","description":"My personal set of non-secret dotfiles","archived":false,"fork":false,"pushed_at":"2026-03-25T16:04:19.000Z","size":163,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-05T15:32:42.756Z","etag":null,"topics":["config","dotfiles","shell","terminal","yadm","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zerebos.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":"2024-10-22T20:03:32.000Z","updated_at":"2026-03-25T16:05:27.000Z","dependencies_parsed_at":"2025-03-26T16:43:28.629Z","dependency_job_id":"5323e521-5a5a-4de8-be13-5dd33e3b8348","html_url":"https://github.com/zerebos/dotfiles","commit_stats":null,"previous_names":["zerebos/dotfiles"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zerebos/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerebos%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerebos%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerebos%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerebos%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zerebos","download_url":"https://codeload.github.com/zerebos/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zerebos%2Fdotfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31775722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T20:17:16.280Z","status":"ssl_error","status_checked_at":"2026-04-13T20:17:08.216Z","response_time":93,"last_error":"SSL_read: 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":["config","dotfiles","shell","terminal","yadm","zsh"],"created_at":"2024-12-04T20:18:43.500Z","updated_at":"2026-04-13T23:31:43.718Z","avatar_url":"https://github.com/zerebos.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zDotfiles\n\nMy personal ZSH dotfiles managed with [yadm](https://yadm.io/). A modern, modular ZSH configuration with curated tools and workflows for Unix/Linux development environments.\n\n## 📸 Screenshots\n\n### Terminal with Powerlevel10k\n![Terminal with P10k theme showing prompt, syntax highlighting, and autosuggestions](https://github.com/user-attachments/assets/5d062fda-5a6f-441f-b200-d4db8f3c1615)\n*Ghostty terminal with Powerlevel10k theme, fast-syntax-highlighting, and autosuggestions*\n\n### Modern CLI Tools\n![Modern CLI tools: eza (ls), bat (cat), and erd (tree) in action](https://github.com/user-attachments/assets/31faf362-ec05-479d-9ef8-76c8747e57fb)\n*Replacements for traditional Unix tools with better output and features*\n\n### Yazi File Manager\n![Yazi TUI file manager with custom theme and plugins](https://github.com/user-attachments/assets/39383293-e937-47bb-9e48-92f416a52582)\n*Full-featured file manager with image previews, git integration, and custom plugins*\n\n### FZF Git Workflow\n![Interactive git commit browser using fzf with preview](https://github.com/user-attachments/assets/723fdfa3-1393-4c7e-81a1-bc907c8110de)\n*The `fshow` command: fuzzy-find git commits with full diff preview*\n\n### Brewfile Helper Tool\n![Brewfile script showing interactive package browser](https://github.com/user-attachments/assets/9dc1e4e9-98f6-417e-b87a-d0e043323d8e)\n*Interactive package selection using the `brewfile view` command*\n\n## ✨ Features\n\n- **🚀 Fast Shell Startup** - P10k instant prompt and optimized loading\n- **📦 Modular Configuration** - Organized into logical components (lib, aliases, plugins)\n- **🎨 Modern CLI Tools** - Replaces traditional Unix tools with modern alternatives\n- **🔍 FZF Integration** - Fuzzy finding everywhere (git, files, scripts)\n- **🛠️ Developer Workflows** - Specialized commands for Go, Node/Bun, Git\n- **🎯 XDG Compliant** - Respects XDG Base Directory standards\n- **📱 Multi-Terminal Support** - Configs for Ghostty, Kitty, Alacritty, WezTerm, Rio\n- **⚡ Auto-Bootstrap** - One command setup with dependency management\n\n## 📋 What's Included\n\n### Shell Configuration\n- **ZSH** with Powerlevel10k theme\n- Syntax highlighting via fast-syntax-highlighting\n- Auto-suggestions via zsh-autosuggestions\n- Smart completion system\n- Custom aliases and functions organized by category:\n  - Navigation shortcuts\n  - Git workflows\n  - File operations\n  - Development tools\n  - Container management\n  - System utilities\n\n### Modern CLI Tools\nReplacements for traditional Unix commands:\n- `eza` → better `ls` with icons and colors\n- `bat` → better `cat` with syntax highlighting\n- `erd` → better `tree` with better layouts\n- `fd` → better `find` with simpler syntax\n- `ripgrep` → faster `grep`\n- `zoxide` → smarter `cd` with frecency\n- `bottom` → better `top` with more features\n- `dua-cli`, `gdu`, `diskonaut` → disk usage analyzers\n\n### Development Tools\n- **Git**: `gh`, `lazygit`, `git-delta`\n- **Editors**: `micro` with custom colorschemes\n- **Languages**: Go, Bun/Node.js, Rust, Zig toolchains\n- **Utils**: `jq`, `yq`, `hyperfine`, `silicon`, `glow`\n- **TUIs**: `yazi` (file manager), `presenterm` (presentations), `fastfetch`\n\n### Applications \u0026 Services\n- File manager: Yazi with plugins\n- Terminal: Multiple configs (Ghostty primary)\n- SSH: Wishlist, termscp\n- 1Password CLI integration\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Git\n- ZSH (this configuration is ZSH-specific)\n- Internet connection\n- Supported OS: macOS or Linux\n  - Note: Windows is supported via WSL, but native Windows Terminal config is not included\n\n### Installation\n\n1. **Install YADM**\n   ```bash\n   # macOS\n   brew install yadm\n\n   # Linux (Ubuntu/Debian)\n   sudo apt install yadm\n\n   # Linux (Arch)\n   sudo pacman -S yadm\n   ```\n\n2. **Clone this repo**\n   ```bash\n   yadm clone https://github.com/zerebos/dotfiles.git\n   ```\n\n3. **Run bootstrap**\n   ```bash\n   yadm bootstrap\n   ```\n\n   This will:\n   - Install Homebrew (if missing)\n   - Install essential tools via Homebrew\n   - Set up Yazi plugins\n   - Configure locale settings\n\n4. **Install additional tool bundles** (optional)\n   ```bash\n   # Install multiple brewfiles at once\n   brewfile install dev dev-go mac\n\n   # Or browse and install individual packages interactively\n   brewfile view dev    # Browse dev tools with fzf\n   brewfile search git  # Search for git-related tools\n\n   # See all available brewfiles\n   brewfile list\n   ```\n\n5. **Set ZSH as default shell** (if not already)\n   ```bash\n   chsh -s $(which zsh)\n   ```\n\n6. **Restart your terminal**\n\n7. **Validate your installation** (optional)\n   ```bash\n   ./bin/validate-dotfiles\n   ```\n   \n   This helper script checks that:\n   - Essential CLI tools are installed\n   - Directory structure is correct\n   - ZSH configuration is properly loaded\n   - Environment variables are set\n   - Custom aliases and functions are available\n   \n   The script is useful for troubleshooting installation issues or verifying your setup after updates.\n\n## 📁 Structure\n\n```\ndotfiles/\n├── .config/\n│   ├── zsh/              # ZSH configuration\n│   │   ├── .zshrc        # Main config file\n│   │   ├── lib/          # Core libraries\n│   │   ├── aliases/      # Categorized aliases\n│   │   └── plugins/      # Plugin configurations\n│   ├── yadm/             # YADM-specific configs\n│   │   ├── bootstrap     # Auto-setup script\n│   │   └── brewfiles/    # Homebrew bundles\n│   ├── git/              # Git configuration\n│   ├── kitty/            # Kitty terminal config\n│   ├── ghostty/          # Ghostty terminal config\n│   ├── alacritty/        # Alacritty terminal config\n│   ├── wezterm/          # WezTerm terminal config\n│   ├── yazi/             # Yazi file manager config\n│   ├── micro/            # Micro editor config\n│   └── ...               # Other app configs\n├── bin/                  # Custom scripts\n└── .zshenv               # ZSH environment setup\n```\n\n## 🎯 Key Aliases \u0026 Functions\n\n### Navigation\n- `..` - Go up one directory\n- `cd` - Aliased to `z` (zoxide) for smart navigation\n- `cdg` - Jump to git root\n- `cdp` - Jump to project root (git, npm, go, cargo)\n- `mkcd \u003cdir\u003e` - Create directory and cd into it\n- `zz` - Fuzzy find and jump to frequent directories\n\n### Git\n- `gs` - git status\n- `ga` - git add\n- `gp` - git pull\n- `gcm` - git commit -m\n- `gpu` - git push\n- `glg` - git log graph\n- `fshow` - Fuzzy find git commits with preview\n- `fstash` - Fuzzy find git stashes with preview\n\n### Files\n- `ls` - eza with icons (if available)\n- `cat` - bat with syntax highlighting\n- `tree` - erd with better layout\n- `ll` - long listing\n- `lla` - long listing with hidden files\n\n### Development\n- `serve [port]` - Start HTTP server (bun or python)\n- `curlj \u003curl\u003e` - Get JSON with pretty printing\n- `rpkg` - Run package.json script (fuzzy select)\n- `lspkg` - List package.json scripts\n- `gor [target]` - Run go program\n- `gob [target]` - Build go program to ./bin\n\n### System\n- `fkill` - Fuzzy find and kill process\n- `gdd` - Show disk usage\n- `btm` - Display system information\n- `listening` - Show open ports\n\n## 🎨 Customization\n\n### Changing the Theme\nThe Powerlevel10k theme can be reconfigured:\n```bash\np10k configure\n```\n\n### Adding Your Own Aliases\nCreate a new file in `.config/zsh/aliases/` with a `.zsh` extension. It will be auto-loaded.\n\n### Adding Custom Brewfiles\nCreate a custom Brewfile in `.config/yadm/brewfiles/` (e.g., `personal.rb`) and install with:\n```bash\nbrewfile install personal\n```\n\n### Terminal Configurations\n\nThis repository includes configurations for multiple terminal emulators. These are maintained to test TUI and CLI applications across different terminals for correctness and compatibility.\n\n**Primary Terminal**:\n- **macOS/Linux**: [Ghostty](https://ghostty.org/) (or [cmux](https://github.com/manaflow-ai/cmux) which uses Ghostty under the hood)\n- **Windows**: Windows Terminal (config not included in dotfiles)\n\n**Additional Terminal Configs** (for testing):\n- **Kitty** - Feature-rich, GPU-accelerated, great image protocol support\n- **Alacritty** - Minimal, very fast, cross-platform\n- **WezTerm** - Lua-configurable, excellent features\n- **Rio** - Modern Rust-based terminal\n\nYou can install any of these terminals and use their respective configs. The shell configuration works seamlessly across all of them.\n\n## 🧩 Installing Additional Tools\n\nAfter the base installation, you can install additional tool bundles using the `brewfile` helper script:\n\n```bash\n# Install specific brewfiles (e.g., dev tools on macOS)\nbrewfile install dev mac\n\n# Interactively browse and install individual packages\nbrewfile view dev    # Browse dev brewfile with fzf\nbrewfile search git  # Search across all brewfiles for packages matching \"git\"\n\n# List available brewfiles\nbrewfile list\n```\n\nAvailable brewfiles:\n- `essentials` - Core CLI tools and TUIs (installed by bootstrap)\n- `dev` - General development tools (git, gh, lazygit, languages)\n- `dev-go` - Go-specific tools and utilities\n- `dev-rust` - Rust toolchain and utilities\n- `dev-zig` - Zig toolchain\n- `dev-extras` - Additional development utilities\n- `dev-gui` - GUI development applications\n- `containers` - Container tools (Docker, Podman, etc.)\n- `mac` - macOS-specific applications\n- `vscode` - VS Code extensions via brew\n\nSee [`bin/brewfile`](bin/brewfile) for full usage details and implementation.\n\n## 🔧 Maintenance\n\n### Update Dotfiles\n```bash\nyadm pull\n```\n\n### Update Tools\n```bash\nbrew update \u0026\u0026 brew upgrade\n```\n\n### Update Yazi Plugins\n```bash\nya pack -u\n```\n\n### Validate Your Setup\nAfter updates or if you encounter issues, verify your installation:\n```bash\n./bin/validate-dotfiles\n```\n\nThis will check all critical components and help identify any missing tools or configuration issues.\n\n### Commit Changes\n```bash\nyadm add \u003cfile\u003e\nyadm commit -m \"Description\"\nyadm push\n```\n\n## 💡 Tips\n\n1. **FZF Keybindings**:\n   - `Ctrl+R` - Search command history\n   - `Ctrl+T` - Search files\n   - `Alt+C` - Search directories\n\n2. **Zoxide Navigation**:\n   - `z foo` - Jump to directory matching \"foo\"\n   - `zi` - Interactive directory selection\n\n3. **Git Workflows**:\n   - Use `fshow` to interactively browse commits\n   - Use `fstash` to view stash contents\n\n4. **Performance**:\n   - The config is optimized for fast startup\n   - Heavy plugins are lazy-loaded\n   - Completions are cached\n\n## 🤝 Contributing\n\nFeel free to open issues or submit PRs if you find bugs or have suggestions!\n\n## 📄 License\n\nMIT License - Feel free to use and modify as you wish.\n\n## 🙏 Credits\n\nBuilt with and inspired by:\n- [yadm](https://yadm.io/) - Dotfile manager\n- [Powerlevel10k](https://github.com/romkatv/powerlevel10k) - ZSH theme\n- [fzf](https://github.com/junegunn/fzf) - Fuzzy finder\n- [zoxide](https://github.com/ajeetdsouza/zoxide) - Smart cd\n- And many other amazing open source tools\n\n---\n\n**Note**: This is a ZSH-specific configuration. While some tools and configs work across shells, the core shell configuration requires ZSH. Review and customize before using.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerebos%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzerebos%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzerebos%2Fdotfiles/lists"}