{"id":13452405,"url":"https://github.com/RichiH/vcsh","last_synced_at":"2025-03-23T19:34:16.700Z","repository":{"id":1444710,"uuid":"1675455","full_name":"RichiH/vcsh","owner":"RichiH","description":"config manager based on Git","archived":false,"fork":false,"pushed_at":"2024-08-20T20:37:31.000Z","size":1037,"stargazers_count":2196,"open_issues_count":72,"forks_count":123,"subscribers_count":47,"default_branch":"main","last_synced_at":"2024-10-15T04:22:52.016Z","etag":null,"topics":["bootstrap","command-line","command-line-tool","dotfiles","dotfiles-automation","dotfiles-install","dotfiles-installer","dotfiles-linux","dotfiles-macos","dotfiles-manager","dotfiles-resources","dotfiles-setup","dotfiles-windows","dotfiles-wsl","posix","posix-sh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RichiH.png","metadata":{"files":{"readme":"README.md","changelog":"changelog","contributing":null,"funding":null,"license":"LICENSE.md","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":"2011-04-28T11:48:30.000Z","updated_at":"2024-10-14T11:19:10.000Z","dependencies_parsed_at":"2024-07-31T07:14:19.738Z","dependency_job_id":null,"html_url":"https://github.com/RichiH/vcsh","commit_stats":{"total_commits":696,"total_committers":58,"mean_commits":12.0,"dds":"0.42385057471264365","last_synced_commit":"41a1e79fae90dc5712f47451ee948b526c7a0246"},"previous_names":[],"tags_count":113,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RichiH%2Fvcsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RichiH%2Fvcsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RichiH%2Fvcsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RichiH%2Fvcsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RichiH","download_url":"https://codeload.github.com/RichiH/vcsh/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221900927,"owners_count":16898993,"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":["bootstrap","command-line","command-line-tool","dotfiles","dotfiles-automation","dotfiles-install","dotfiles-installer","dotfiles-linux","dotfiles-macos","dotfiles-manager","dotfiles-resources","dotfiles-setup","dotfiles-windows","dotfiles-wsl","posix","posix-sh"],"created_at":"2024-07-31T07:01:23.285Z","updated_at":"2024-10-28T18:31:16.703Z","avatar_url":"https://github.com/RichiH.png","language":"Shell","funding_links":[],"categories":["Shell","Shell Package Management","bootstrap","Archive/abandoned projects"],"sub_categories":["Directory Navigation","macOS"],"readme":"vcsh - Version Control System for $HOME - multiple Git repositories in $HOME\n\n[![Test Status](https://github.com/RichiH/vcsh/actions/workflows/test.yml/badge.svg)](https://github.com/RichiH/vcsh/actions/workflows/test.yml)\n\n# Index\n\n1. [30 Second How-to](#30-second-how-to)\n2. [Introduction](#introduction)\n3. [Installation](#installation)\n4. [Detailed documentation](#detailed-documentation)\n5. [Contact](#contact)\n\n\n# 30 Second How-to\n\nWhile it may appear that there's an overwhelming amount of documentation and\nwhile the explanation of the concepts behind `vcsh` needs to touch a few gory\ndetails of `git` internals, getting started with `vcsh` is extremely simple.\n\nLet's say you want to version control your `vim` configuration:\n\n    vcsh init vim\n    vcsh vim add ~/.vimrc ~/.vim\n    vcsh vim commit -m 'Initial commit of my Vim configuration'\n    # optionally push your files to a remote\n    vcsh vim remote add origin \u003cremote\u003e\n    vcsh vim push -u origin master\n    # from now on you can push additional commits like this\n    vcsh vim push\n\nIf all that looks a _lot_ like standard `git`, that's no coincidence; it's\na design feature.\n\n\n# Introduction\n\n[vcsh][vcsh] allows you to maintain several Git repositories in one single\ndirectory. They all maintain their working trees without clobbering each other\nor interfering otherwise. By default, all Git repositories maintained via\n`vcsh` store the actual files in `$HOME` but you can override this setting if\nyou want to.\n\nAll this means that you can have one repository per application or application\nfamily, i.e. `zsh`, `vim`, `ssh`, etc. This, in turn, allows you to clone\ncustom sets of configurations onto different machines or even for different\nusers; picking and mixing which configurations you want to use where.\nFor example, you may not need to have your `mplayer` configuration on a server\nor available to root and you may want to maintain different configuration for\n`ssh` on your personal and your work machines.\n\n## Talks\n\nSome people found it useful to look at [slides](https://github.com/RichiH/talks/blob/main/2013/10-linuxcon-eu/linuxcon_eu-2013-10-gitify_your_life.pdf) and videos explaining how `vcsh`\nworks instead of working through the docs.\nAll slides, videos, and further information can be found\n[on the author's talk page][talks].\n\n# Installation\n\nA lot of modern UNIX-based systems offer packages for `vcsh`. In case yours\ndoes not, read [INSTALL.md](doc/INSTALL.md) for instructions on installing from\nsources or even create a package for your system. If you do end up packaging\n`vcsh` please let us know so we can document package availability.\n\n# Detailed documentation\n\nFor more information, consult the [detailed documentation](doc/README.md).\n\n# Contact\n\nThere are several ways to get in touch with the author and a small but committed\ncommunity around the general idea of version controlling your (digital) life.\n\n* IRC: #vcs-home on irc.oftc.net\n\n* Mailing list: [http://lists.madduck.net/listinfo/vcs-home][vcs-home-list]\n\n* Pull requests or issues on [https://github.com/RichiH/vcsh][vcsh]\n\n\n[myrepos]: http://myrepos.branchable.com/\n[talks]: https://github.com/RichiH/talks\n[vcsh]: https://github.com/RichiH/vcsh\n[vcs-home-list]: http://lists.madduck.net/listinfo/vcs-home\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRichiH%2Fvcsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRichiH%2Fvcsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRichiH%2Fvcsh/lists"}