This is a management suite for dotfiles. See the tutorial to get started quickly.
It assumes that you have a separate dotfiles directory, or are interested in creating one.
sudo apk add rcm
Debian (see further down for Ubuntu):
sudo wget -q https://apt.thoughtbot.com/thoughtbot.gpg.key -O /etc/apt/trusted.gpg.d/thoughtbot.gpg echo "deb https://apt.thoughtbot.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/thoughtbot.list sudo apt-get update sudo apt-get install rcm
sudo dnf install rcm
sudo pkg install rcm
64-bit Korora 23:
sudo dnf copr enable seeitcoming/rcm fedora-23-x86_64 sudo dnf install rcm
Korora is similar to Fedora but with an additional version and architecture
macOS with Homebrew:
brew install rcm
macOS with MacPorts:
port install rcm
doas pkg_add rcm
Ubuntu (19.04 or later):
sudo apt update sudo apt install rcm
Ubuntu (12.04, 14.04, 16.04, 18.04, or 18.10):
sudo apt-get install software-properties-common sudo add-apt-repository ppa:martin-frost/thoughtbot-rcm sudo apt-get update sudo apt-get install rcm
sudo xbps-install -S rcm
This uses the standard GNU autotools, so it's the normal dance:
curl -LO https://thoughtbot.github.io/rcm/dist/rcm-1.3.4.tar.gz && sha=$(sha256 rcm-1.3.4.tar.gz | cut -f1 -d' ') && [ "$sha" = "9b11ae37449cf4d234ec6d1348479bfed3253daba11f7e9e774059865b66c24a" ] && tar -xvf rcm-1.3.4.tar.gz && cd rcm-1.3.4 && ./configure && make && sudo make install
For more, see
- rcup(1) is the main program. It is used to install and update dotfiles, with support for tags, host-specific files, and multiple source directories.
- rcdn(1) is the opposite of rcup(1).
- mkrc(1) is for introducing a dotfile into your dotfiles directory, with support for tags and multiple source directories.
- lsrc(1) shows you all your dotfiles and where they would be symlinked to. It is used by rcup(1) but is provided for your own use, too.
Pull requests welcome; see
Copyright 2013 Mike Burns. BSD license. Copyright 2014-2015 thoughtbot. BSD license.
RCM is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.