Skip to content
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
Cannot retrieve contributors at this time

$ et_

What is Env Tracker (et)?

If you're a web developer, you probably have some files in your project with names like ".env", which store private data like passwords and api keys. Unfortunately, sane practices dictate that you hide these important files from source control (for good reason!) by adding their names to .gitignore.

Not having source control on those files kind of sucks, because source control preserves file histories and allows you to easily revert changes when you rollback commits or change branches.

Env Tracker is a CLI tool that adds private, local source control to your private files so you don't lose them.


How does it work?

Env Tracker creates a git repository parallel to your project repository. When you tell Env Tracker to monitor a file, it moves that file into the parallel repository and symlinks the file back to its original location.

As far as your project is concerned, nothing has changed, but now you have source control on your private files.

Before Env Tracker


After Env Tracker


    .env@ -> ~/.et/my-project/.env


  • It should be able to be used without requiring buy-in from other project collaborators. Your colleagues shouldn't know that you're using Env Tracker unless you tell them. That means not touching any of the tracked repository files, including .gitignore.
  • It should require as few commands as possible.
  • It should rely only on the filesystem for state, instead of a database or configuration files.


Install and update using pip.

pip install env-tracker

Env Tracker currently supports only python 3.6+, but plans to support 2.7 and 3.4+


Coming soon


Coming soon


Run python develop to install the package locally Run python develop --uninstall to uninstall the local installation See


Coming soon.


Coming soon


  • Website:
  • Documentation:
  • License:
  • Releases:
  • Code:
  • Issue tracker:
  • Test status:
  • Linux, Mac:
  • Windows:
  • Test coverage: