{"id":24535192,"url":"https://github.com/cebor/dotfiles","last_synced_at":"2026-04-13T23:02:40.421Z","repository":{"id":14345411,"uuid":"17054996","full_name":"cebor/dotfiles","owner":"cebor","description":"Cebor's macOS dotfiles","archived":false,"fork":false,"pushed_at":"2025-11-28T13:15:58.000Z","size":388,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-30T18:10:18.761Z","etag":null,"topics":["brew","dotfiles","macos"],"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/cebor.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2014-02-21T11:56:44.000Z","updated_at":"2025-11-28T13:16:02.000Z","dependencies_parsed_at":"2024-06-05T20:59:11.556Z","dependency_job_id":"87f944bc-b816-494c-8d04-38af8d1aca2d","html_url":"https://github.com/cebor/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cebor/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cebor%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cebor%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cebor%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cebor%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cebor","download_url":"https://codeload.github.com/cebor/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cebor%2Fdotfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31774547,"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":["brew","dotfiles","macos"],"created_at":"2025-01-22T12:16:05.073Z","updated_at":"2026-04-13T23:02:40.416Z","avatar_url":"https://github.com/cebor.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dotfiles\n\nPersonal macOS configuration and dotfiles management system.\n\n## Quick Start\n\n### First-Time Setup\n\n```bash\ngit clone \u003crepository-url\u003e ~/.dotfiles\ncd ~/.dotfiles\n./install.sh      # Automatically runs bootstrap if needed, then installs everything\nexec zsh          # Reload shell\n```\n\n### Regular Updates\n\n```bash\n./install.sh      # Safe to re-run - updates packages and syncs dotfiles\n# Or for quick dotfile-only syncs:\n./sync.sh -f      # Sync dotfiles without package updates\n```\n\n## What's Included\n\n### Shell Configuration\n- **Zsh** with [antidote](https://getantidote.github.io/) plugin manager\n- **Starship** prompt\n- Oh My Zsh plugins (git, brew, extract)\n- Enhanced utilities (zsh-autosuggestions, zsh-syntax-highlighting, z)\n\n### Applications (via Homebrew)\n- Development: helix, vim, git, python, node, docker\n- Networking: httpie, nmap, mtr, wrk\n- Kubernetes: kubectl, helm, yq\n- GUI apps: iTerm2, VS Code, Firefox, Obsidian, and more\n\nSee [`Brewfile`](Brewfile) for the complete list.\n\n### Custom Functions \u0026 Aliases\n\n**Smart Python venv activation:**\n```bash\nsvenv  # Finds and activates venv/.venv/poetry/pipenv in parent directories\n```\n\n**File sharing:**\n```bash\nscpp file.txt  # Upload to stkn.org and copy URL to clipboard\n```\n\n**Utilities:**\n```bash\nserver 8080       # Start HTTP server on port 8080\ntunnel host 3306 3307  # SSH port forwarding\npwgen 20          # Generate 20-character password\n```\n\nSee [`.aliases`](system/.aliases) and [`.functions`](system/.functions) for all shortcuts.\n\n## Scripts\n\n| Script | Purpose | When to Use |\n|--------|---------|-------------|\n| `bootstrap.sh` | One-time system setup (Xcode CLI tools, Homebrew) | First installation only (or run automatically by install.sh) |\n| `install.sh` | Full installation - auto-runs bootstrap if needed, installs/updates packages, sets brewed zsh as default shell | First-time setup AND regular updates (safe to re-run) |\n| `sync.sh` | Sync dotfiles only (supports `-f`, `-d` flags) | Quick dotfile-only syncs or testing changes |\n| `git.sh` | Apply git config settings, prompts for user.name/email if not set | Called by install.sh |\n\n### Script Flags\n\n```bash\n./sync.sh -d      # Dry-run: preview changes without syncing\n./sync.sh -f      # Force: skip confirmation prompt\n```\n\n## Project Structure\n\n```\ndotfiles/\n├── git/          # Git-specific config (.gitignore_global, .gitattributes_global)\n├── system/       # Shell and app dotfiles (.zshrc, .vimrc, .tmux.conf, etc.)\n├── *.sh          # Setup and maintenance scripts\n├── Brewfile      # Homebrew package definitions\n└── .github/      # AI agent instructions\n```\n\nFiles in `git/` and `system/` are synced to `$HOME` via rsync.\n\n## Customization\n\n1. **Add a package**: Edit `Brewfile` → run `brew bundle` or `./install.sh`\n2. **Add an alias**: Edit `system/.aliases` → run `./sync.sh -f` → reload shell\n3. **Add a zsh plugin**: Edit `system/.zsh_plugins.txt` → run `./sync.sh -f` → reload shell\n4. **Modify macOS settings**: Edit `macos.sh` → run `./macos.sh` → restart affected app\n\n## Configuration Highlights\n\n### Git\n- Default editor: **helix** (`hx`)\n- Default branch: `main`\n- Credentials stored in macOS keychain\n\n### Vim\n- Plugin manager: vim-plug\n- Theme: Solarized Dark\n- Persistent undo, automatic position restore\n\n### macOS\n- Finder: show path bar, status bar, all extensions\n- Dock: minimize to application, auto-hide\n- Trackpad: tap to click enabled\n\nSee [`macos.sh`](macos.sh) for all system preferences.\n\n## Maintenance\n\n### Preview Changes\n```bash\n./sync.sh -d  # See what would change without applying\n```\n\n### Update Everything\n```bash\n./install.sh  # Syncs dotfiles, updates packages, reconfigures git/vim/macOS\n```\n\n## Requirements\n\n- macOS (tested on recent versions)\n- Xcode Command Line Tools (installed by `bootstrap.sh`)\n- Internet connection for initial setup\n\n## License\n\nMIT - See [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcebor%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcebor%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcebor%2Fdotfiles/lists"}