{"id":17148450,"url":"https://github.com/mavam/dotfiles","last_synced_at":"2025-04-09T23:19:05.306Z","repository":{"id":1118924,"uuid":"990194","full_name":"mavam/dotfiles","owner":"mavam","description":":desktop_computer: The very heart of an efficient work environment","archived":false,"fork":false,"pushed_at":"2025-03-24T09:29:35.000Z","size":4278,"stargazers_count":52,"open_issues_count":5,"forks_count":22,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-02T16:56:00.082Z","etag":null,"topics":["dotfiles","git","mutt","tmux","vim","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/mavam.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}},"created_at":"2010-10-15T15:20:46.000Z","updated_at":"2025-03-24T09:29:39.000Z","dependencies_parsed_at":"2023-01-11T15:49:41.107Z","dependency_job_id":"f5ac5ca0-7e11-4e72-a6ff-6ae662e8d81f","html_url":"https://github.com/mavam/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mavam%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mavam%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mavam%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mavam%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mavam","download_url":"https://codeload.github.com/mavam/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248125668,"owners_count":21051780,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","git","mutt","tmux","vim","zsh"],"created_at":"2024-10-14T21:28:42.253Z","updated_at":"2025-04-09T23:19:05.298Z","avatar_url":"https://github.com/mavam.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dotfiles\n\n\u003e Proper dotfiles are the very heart of an efficient working environment.\n\n- **Terminals**: [GhostTTY](https://ghostty.org/)\n- **Shell**: [Fish](https://fishshell.com/)\n- **Editor**: [NeoVim](https://neovim.io/)\n- **Colorscheme**: GitHub Light \u0026 Dark\n- **Font**: [Fira Code](https://github.com/tonsky/FiraCode)\n  from [Nerd Fonts](https://github.com/ryanoasis/nerd-fonts)\n\nOn macOS, [Homebrew](https://brew.sh) is the package manager.\n\n## Usage\n\n### Synopsis\n\nClone this repository and optionally bootstrap your system:\n\n```sh\ngit clone git@github.com:mavam/dotfiles.git ~/.dotfiles\ncd .dotfiles\n./bootstrap\n```\n\nThe bootstrap script will ask you whether you'd like to setup specific components.\n\n### Dotfile Management\n\nThe POSIX shell script [dots](dots) installs (= symlinks) and removes subsets\nof dotfiles according to your needs. For example, install all dotfiles as\nfollows:\n\n```sh\n./dots install -a\n```\n\nAlternatively, install only dotfiles selectively, with positional arguments\nmatching directory names in this repository:\n\n```sh\n./dots install git gnupg\n```\n\nSimilarly, remove all installed dotfiles:\n\n```sh\n./dots uninstall -a\n```\n\nThe installer script does not override existing dotfiles unless the command\nline includes the `-f` switch. When in doubt what the installation of a subset\nof the dotfiles would look like, it is possible to look at the diff first:\n\n```sh\n./dots diff -a\n```\n\nTo add a configuration for an exemplary tool \"foo\", create a new directory\n`foo` and add the dotfiles in there, as if `foo` is your install prefix\n(typically `$HOME`). You can \"scope\" a tool as *local* by adding a tag-file\n`foo/LOCAL`. This has the effect of creating a nested configuration directory\nin your prefix, instead of symlinking the directory. For example, you may not\nwant to symlink `~/.gnupg` but only the contained file `~/.gnupg/gpg.conf`.\nWithout the scope tag `gnupg/LOCAL`, you would end up with:\n\n```sh\n~/.gnupg -\u003e dotfiles/gpg/.gnupg\n```\n\nas opposed to:\n\n```txt\n~/.gnupg (local directory)\n~/.gnupg/gpg.conf -\u003e dotfiles/gpg/.gnupg/gpg.conf\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmavam%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmavam%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmavam%2Fdotfiles/lists"}