https://github.com/tagae/dotfiles
dotfiles manager for GNU/Linux and macOS
https://github.com/tagae/dotfiles
dotfiles git
Last synced: about 2 months ago
JSON representation
dotfiles manager for GNU/Linux and macOS
- Host: GitHub
- URL: https://github.com/tagae/dotfiles
- Owner: tagae
- Created: 2012-09-06T12:39:53.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2026-04-20T14:56:11.000Z (2 months ago)
- Last Synced: 2026-04-20T16:44:45.029Z (2 months ago)
- Topics: dotfiles, git
- Language: Shell
- Homepage:
- Size: 133 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
dotfiles
========
Yet another [GitHub dotfiles repository].
Dotfiles are managed in a git repository and symlinked from there to your home
directory.
The `master` branch contains the pristine (empty) configuration, and other
branches contain the different configurations adapted to personal preferences,
platforms and hosts. These configurations might be merged as needed using
regular git workflows.
Installation
------------
Issue
git clone git@github.com:tagae/dotfiles.git ~/.dotfiles
Any directory can be used as destination.
Merge the branches that correspond to your personal preferences, platform
(macOS / Linux) and host.
The `bin` directory in the repository contains the `dotfiles` command, which
you can use to perform a number of actions on your dotfiles.
Importing Dotfiles
------------------
To import an existing `~/.file` into the dotfiles repository, do
dotfiles import ~/.file
This will move the file into the git-managed repository, and replace it by a
symlink to the moved file.
Using dotfiles
--------------
To use a dotfile from the repository, do
dotfiles use ~/.dotfiles/share/file
This will create a `~/.file` symlink pointing to `~/.dotfiles/share/file`.
Ejecting dotfiles
-----------------
To stop managing a dotfile and turn it back into a plain dotfile living in your
home directory, do
dotfiles eject ~/.file
This will replace the symbolic link `~/.file` by the actual file itself.
This action is the reverse of `import`, except for the git history, which only
grows.
[GitHub dotfiles repository]: http://dotfiles.github.com/