Quick Start


  • Linux or Mac system (This for you if you’re comfy with the terminal)
  • git
  • watcher (only for Linux)


Following steps would get you started:

  1. Download Live Version.
  2. Go to the LiveVersion folder and execute source ./setup.
  3. If you see “Success!”, all went well. It is ready.
$ cd lv-master 
$ source ./setup

Quick Usage

$ watch foldername or filename


1. $ watch ~/projects/my_project    # watch folder my_project
2. $ watch ~/.bash_profile          # watch file .bash_profile
3. $ watch /etc/hosts               # watch file /etc/hosts to track configuration

In Example 1. watch ~/projects/my_project, watch command will:

  • Will ask for the default values (first time only).
  • Create a Live Repository in ~/LiveRepos.
  • On Mac, Create a new LaunchAgent to watch the folder.
  • On Linux, Create a new Watcher job or incrond entry.
  • Live Version activity would be logged in ~/logs/my_project.projects.log by default.

Note: incrond works only at single directory level, changes in subdirectories are not tracked by it.

Advance Usage

$ lv /full/source/path /full/destination/path [/log/file] [email]


  • /full/source/path is the absolute path of the file or folder that you want to be versioned live.
  • /full/destination/path is absolute path of the Live Repository where a versioned copy of the source would reside.
  • /log/file is an optional parameter that gives absolute path of the log file where log of activities would be kept.
  • email is an experimental feature; works only on shell environment.

This is one time execution, you may want to add this to your build script or custom launchd property list file, or incrontab entry.


To harness the power of Live Version, you would need a graphical git client such as Source Tree.

Once you have the client, you can open your Live Repository in the client and see the changes in much clear context.

Check out documentation for more details.

Happy Versioning!