Skip to main content

link to git

Project description

This tool stores files in a git repository and creates links instead automatically. Files are kept in the same structure as they were before but can be categorized for easy accessibility.

using ltg

A typical folder will look a bit like this:

$ ls -ARl ~/.ltg
total 84K
drwxr-xr-x 2 user users 4.0K Jun  4 20:04 general
drwxr-xr-x 2 user users 4.0K Jun  4 20:04 vim
drwxr-xr-x 8 user users 4.0K Jun  5 21:53 .git
-rw-r--r-- 1 user users   43 Jun  4 20:06 .gitmodule

total 12K
drwxr-xr-x 2 user users 4.0K Jun  4 13:11 .gitconfig
drwxr-xr-x 3 user users 4.0K Jun  4 13:22 .i3
-rw-r--r-- 1 user users 3.9K Jun  4 12:14 .bash_prompt
-rw-r--r-- 1 user users 5.6K Jun  5 01:26 .bashrc

total 4.0K
drwxr-xr-x 3 user users 4.0K Jun  4 13:22 .vim


Getting there is really simple. To add a new file, call store:

$ ltg store ~/.xinitrc ~/.Xdefaults ~/.bashrc
$ ltg store --category vim ~/.vim

it will now be added to your dotfile folder (by default ~/.ltg), a git repository should be set up and the files have been added to the index.

To link the files or recreate lost links you can use link:

$ ltg link -f

ltg will then automatically create links to all stored files instead of the original.

To automatically store and link files, use add:

$ ltg add -c vim .vim

To update changed files run:

$ ltg git -- add ~/dotfiles/bash/.bashrc

or simply:

$ ltg git -- add -A

The git command forwards commands directly to git (with baked in directories), meaning you can run:

$ ltg git -- remote add origin
$ ltg git -- pull --recurse-submodules origin master
$ ltg link
$ ltg add -c bash ~/.bashrc
$ ltg git -- push

There is a handy command group available to simplify pulling and pushing, sync:

$ ltg sync down
$ ltg sync up

will first pull remote changes (via rebase) and then push local changes in a single commit.


  • unlinking

  • removing

  • atomatic commit messages

  • simplify git integration

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ltg-0.2.5.tar.gz (9.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page