{"id":20652447,"url":"https://github.com/thesofakillers/dotfiles","last_synced_at":"2026-05-02T08:31:58.991Z","repository":{"id":42402262,"uuid":"228236516","full_name":"thesofakillers/dotfiles","owner":"thesofakillers","description":"⚙️ bash, vim, etc.","archived":false,"fork":false,"pushed_at":"2026-03-12T22:20:51.000Z","size":16958,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-13T04:53:05.970Z","etag":null,"topics":["dotfiles","neovim","vim"],"latest_commit_sha":null,"homepage":"","language":"Vim Script","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/thesofakillers.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":"2019-12-15T19:09:17.000Z","updated_at":"2026-03-12T22:20:54.000Z","dependencies_parsed_at":"2024-05-30T17:01:12.118Z","dependency_job_id":"d184526a-a9a8-452c-8d6e-8b39ea769d70","html_url":"https://github.com/thesofakillers/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thesofakillers/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesofakillers%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesofakillers%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesofakillers%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesofakillers%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thesofakillers","download_url":"https://codeload.github.com/thesofakillers/dotfiles/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thesofakillers%2Fdotfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32528196,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["dotfiles","neovim","vim"],"created_at":"2024-11-16T17:35:00.645Z","updated_at":"2026-05-02T08:31:58.984Z","avatar_url":"https://github.com/thesofakillers.png","language":"Vim Script","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dotfiles\n\n## Quick Start\n\nOn a fresh machine, logged in as your regular user:\n\n```bash\ngit clone \u003cyour-dotfiles-repo-url\u003e ~/dotfiles\ncd ~/dotfiles\n./bootstrap.sh\nexec bash -l\n```\n\nWhat `bootstrap.sh` does:\n\n- asks a short interactive questionnaire first, then executes the selected\n  setup plan\n- installs baseline packages via manifests:\n  - `apt`: `manifests/apt-packages.txt`\n  - Homebrew: `Brewfile` (with fallback `manifests/brew-packages.txt`)\n- optionally installs developer runtimes (`uv`, `bun`, and `node` via `n`)\n- symlinks the main dotfiles and managed directories (`.codex`, `.vim`, and\n  top-level entries under `.config`)\n- backs up any replaced files to `~/.dotfiles-backups/\u003ctimestamp\u003e/...`\n- creates a local-only git template at `~/.config/git/config.secret`\n- sets up Neovim Python host in `~/.local/share/nvim-py3` with `pynvim`\n  - on Debian/Ubuntu, bootstrap auto-installs missing `python3-venv` support\n    when needed\n- installs `tmux` TPM plugin manager\n- skips package installation if no supported package manager is found\n\nUseful flags:\n\n```bash\n./bootstrap.sh --non-interactive\n./bootstrap.sh --skip-packages --without-runtimes\n./bootstrap.sh --without-homebrew\n./bootstrap.sh --with-nvim-plugins\n```\n\nAfter first login:\n\n- start `tmux`, then press `prefix + I` to install tmux plugins\n- run `nvim +PlugInstall +qall` and/or `vim +PlugInstall +qall` once to\n  install plugins\n\n## Manual Linking\n\nIf you prefer manual setup, clone this repository and create symlinks from files\ninside the repo into your `$HOME`.\n\nExample:\n\n```bash\nln -s /path/to/dotfiles/.bashrc ~/.bashrc\n```\n\n## Vim/Neovim\n\n### Neovim / Coc specifics\n\n- Coc uses `~/n/bin/node`; keep `n` on PATH.\n- Coc extensions live in `~/.config/coc/extensions`; run `:CocUpdate` after\n  changing Node.\n- Neovim Python host lives in `~/.local/share/nvim-py3` with `pynvim` installed\n  (recreate with `python3 -m venv ~/.local/share/nvim-py3 \u0026\u0026\n~/.local/share/nvim-py3/bin/pip install -U pynvim`).\n- Built-in node/perl/ruby providers are disabled; only Coc’s node host is used.\n- Coc-pyright is installed. Ruff lint/format uses `~/.scripts/ruff-fallback`:\n  looks for `./.venv/ruff`, then PATH ruff, else no-op (prevents EPIPE when\n  ruff is missing). Install ruff in each project venv for full lint/format.\n\n## Additional Local Setup (Mac)\n\nMost setup is covered by `bootstrap.sh`. For macOS terminal terminfo compatibility,\nyou may still need:\n\n- [mac_finish.sh](mac_finish.sh)\n\n### tmux without root\n\nFor installing tmux without needing root access, please refer to\n`tmux_local_install.sh`\n\n### Local-only git config\n\nUse `~/.config/git/config.secret` for machine-specific git settings you do not\nwant to commit.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthesofakillers%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthesofakillers%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthesofakillers%2Fdotfiles/lists"}