{"id":14069794,"url":"https://github.com/jgillman/dotfiles","last_synced_at":"2025-07-30T06:32:53.884Z","repository":{"id":2969835,"uuid":"3984904","full_name":"jgillman/dotfiles","owner":"jgillman","description":"jgillman's special collection of configs","archived":false,"fork":false,"pushed_at":"2024-01-25T22:45:34.000Z","size":794,"stargazers_count":18,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-30T17:51:37.777Z","etag":null,"topics":["bash","dotfiles","shell","tweaks","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/jgillman.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":"2012-04-10T17:20:39.000Z","updated_at":"2024-10-03T03:39:32.000Z","dependencies_parsed_at":"2024-01-26T00:01:38.727Z","dependency_job_id":null,"html_url":"https://github.com/jgillman/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/jgillman%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgillman%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgillman%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgillman%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jgillman","download_url":"https://codeload.github.com/jgillman/dotfiles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228102277,"owners_count":17869817,"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":["bash","dotfiles","shell","tweaks","zsh"],"created_at":"2024-08-13T07:07:14.358Z","updated_at":"2025-07-30T06:32:53.870Z","avatar_url":"https://github.com/jgillman.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# jgillman's special dotfiles\n\n## Shoutout\n\nAll of this was originally forked from and later inspired by [holman's\ndotfiles](https://github.com/holman/dotfiles). While the original Ruby\ndependencies have been removed the main strategy of using \"topic\" folders is\nstill here which, imo, is the best part.\n\n## dotfiles\n\nDotfiles are essentially what makes your environment *yours*. All your unique\nlittle tweaks and settings that make your computer completely unusable and\nforeign to others. I had originally kept all my dotfiles in Dropbox which\nworked really nicely for a long time. Two big issues I had with my Dropbox\nsetup is that 1) I would manually have to symlink new files/folders and 2) I\ncouldn't use them on remote development machines (where I often work).\n\nAlso, to steal directly from [holman](https://github.com/holman):\n\n\u003e I was a little tired of having long alias files and everything strewn about\n\u003e (which is extremely common on other dotfiles projects, too). That led to this\n\u003e project being much more topic-centric. I realized I could split a lot of\n\u003e things up into the main areas I used (Ruby, git, system libraries, and so on),\n\u003e so I structured the project accordingly.\n\u003e\n\u003e If you're interested in the philosophy behind why projects like these are\n\u003e awesome, you might want to [read my post on the\n\u003e subject](http://zachholman.com/2010/08/dotfiles-are-meant-to-be-forked/).\n\n## install\n\n- `git clone git@github.com:jgillman/dotfiles.git ~/.dotfiles`\n- `cd ~/.dotfiles`\n- `./dotfiles.sh install`\n\nThe install task will symlink the appropriate files in `.dotfiles` to your home\ndirectory. Everything is configured and tweaked within `~/.dotfiles`, though.\n\n## topical\n\nEverything's built around topic areas. If you're adding a new area to your\ndotfiles — say, \"Java\" — you can simply add a `java` directory and put files in\nthere. Anything with an extension of `.bash`, `.zsh`, or `.fish` will get\nautomatically included into that respective shell. Anything with an extension\nof `.symlink` will get symlinked without extension into `$HOME`. Files that\nneed custom linking (for example, into `~/.config/`) can be handled through\n`link.sh` files within each topic.\n\n## components\n\nThere's a few special files in the hierarchy.\n\n- **bin/**: Anything in `bin/` will get added to your `$PATH` and be made\n  available everywhere.\n- **topic/\\*.zsh**: Any files ending in `.zsh` get loaded into your\n  environment.\n- **topic/\\*.symlink**: Any files ending in `*.symlink` get symlinked into\n  your `$HOME`. This is so you can keep all of those versioned in your dotfiles\n  but still keep those autoloaded files in your home directory. These get\n  symlinked in when you run `rake install`.\n- **topic/\\*.completion.sh**: Any files ending in `completion.sh` get loaded\n  last so that they get loaded after we set up zsh autocomplete functions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgillman%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjgillman%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgillman%2Fdotfiles/lists"}