{"id":17654584,"url":"https://github.com/jpbruinsslot/dot","last_synced_at":"2026-03-03T10:31:11.106Z","repository":{"id":36066828,"uuid":"40366060","full_name":"jpbruinsslot/dot","owner":"jpbruinsslot","description":"simple dotfiles tracking","archived":false,"fork":false,"pushed_at":"2023-12-29T17:26:34.000Z","size":3840,"stargazers_count":12,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-07T09:15:01.273Z","etag":null,"topics":["cli","dotfiles"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/jpbruinsslot.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}},"created_at":"2015-08-07T15:03:34.000Z","updated_at":"2024-08-27T19:41:26.000Z","dependencies_parsed_at":"2024-06-21T18:58:41.045Z","dependency_job_id":"1fb82970-2faa-4ad7-879d-f53827aea29e","html_url":"https://github.com/jpbruinsslot/dot","commit_stats":null,"previous_names":["erroneousboat/dot"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jpbruinsslot/dot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpbruinsslot%2Fdot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpbruinsslot%2Fdot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpbruinsslot%2Fdot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpbruinsslot%2Fdot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jpbruinsslot","download_url":"https://codeload.github.com/jpbruinsslot/dot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jpbruinsslot%2Fdot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30041239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T10:28:37.494Z","status":"ssl_error","status_checked_at":"2026-03-03T10:28:28.686Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["cli","dotfiles"],"created_at":"2024-10-23T12:35:10.530Z","updated_at":"2026-03-03T10:31:11.046Z","avatar_url":"https://github.com/jpbruinsslot.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"Dot - simple dotfile manager\n============================\n\n`dot` provides a cli application which will streamline the process of adding\nand removing files to and from your archive. Using `dot` in combination with a\nhosted repository you'll be able to backup, restore and sync your dotfiles for\nseveral machines. Why would you want your dotfiles hosted in a repository? For\nthe answer and much more click [here](https://dotfiles.github.io). \n\n`dot` works by placing a selected dotfile into the archive and symlinking it\nto its original location. The archive serves as a repository and can be\npersisted using a hosted git repository.\n\nInstallation\n------------\n\n#### Binary installation\n\n[Download](https://github.com/jpbruinsslot/dot/releases) a\ncompatible binary for your system. For convenience, place `dot` in a\ndirectory where you can access it from the command line. Usually this is\n`/usr/local/bin`.\n\n```bash\n$ mv dot /usr/local/bin\n```\n\n#### Via Go\n\nIf you want, you can also get `dot` via Go:\n\n```bash\n$ go get -u github.com/jpbruinsslot/dot\n$ cd $GOPATH/src/github.com/jpbruinsslot/dot\n$ go install .\n```\n\nSetting up\n----------\n\nTo begin using `dot` we need to create a folder in your home folder where we\nwill track the dotfiles. And initializing a git repository.\n\n```bash\n$ mkdir ~/.dotfiles\n$ git init\n```\n\nUsage\n-----\n\nTo start using `dot`, go to the newly created directory and issue the\nfollowing command:\n\n```bash\n$ dot sync\n```\n\nThis will initialize the necessary folder and create a `.dotconfig`\nconfiguration file which will automatically be tracked in the archive.\n\n#### Tracking files or folders\n\nYou can use the following command to start tracking files or folders:\n\n```bash\n# dot add -name [name] -path [path/to/file]\n$ dot add nvimrc /home/jpbruinsslot/.nvimrc\n```\n\nTo remove a file or folder for tracking, use the following command:\n\n```bash\n# dot rm -name [name]\n$ dot rm -name nvimrc\n```\n\nIn order to automatically create a git commit message and push to the\nrepository, pass in the `-push` flag. You can use this for both the\n`add` and `rm` command.\n\n```bash\n$ dot add -name nvimrc -path /home/jpbruinsslot/.nvimrc -push\n$ dot rm -name nvimrc -push\n```\n\n#### Additional machines\n\nSo you've started tracking your files on one machine but now you want to use\nyour archive on another machine. Clone your repository on the additional\nmachine and use the `dot sync` command to start synchronizing your files on the\nnew machine.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpbruinsslot%2Fdot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjpbruinsslot%2Fdot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjpbruinsslot%2Fdot/lists"}