Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A command-line folder manager for many projects.

Project Description

A command-line folder manager for archiving old projects.

proj assumes the following working setup:

  • You have a directory of active projects that you’re working on (e.g. ~/Projects)
  • You have a directory of inactive projects, your archive (e.g. ~/Archive)

Given this setup, proj helps you add and remove projects from your archive, and keeps your archive organised in <year>/<quarter> subfolders, based on when each project was last worked on.


Install the package with pip:

pip install git+git://

Then, tell proj where your archive directory is, by adding a line to your .bashrc or .zshrc file:

export PROJ_ARCHIVE=~/Archive


Use proj to get rid of clutter in your main directory of projects by archiving ones that aren’t being worked on. Proj will detect when you last made a change and file it accordingly.

$ ls
cocktails-that-are-blue   news-for-llamas   old-crusty-project
$ proj archive old-crusty-project
old-crusty-project -> /Users/lars/Archive/2012/q3/old-crusty-project
$ ls
cocktails-that-are-blue   news-for-llamas
$ proj list

Now we’ve archived this project, but we can restore it at any time.

$ proj restore old-crusty-project
/Users/lars/Archive/2012/q3/old-crusty-project -> old-crusty-project
$ ls
cocktails-that-are-blue   news-for-llamas   old-crusty-project


  • proj archive: archive a project to an appropriate directory
  • proj restore: restore a project from the archive
  • proj list: search the archive for a project


0.1.0 (2014-01-11)

  • First release on PyPI.
  • Archive, restore and search features.
Release History

Release History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
proj-0.1.0-py2.py3-none-any.whl (5.9 kB) Copy SHA256 Checksum SHA256 3.4 Wheel Oct 16, 2014
proj-0.1.0.tar.gz (14.3 kB) Copy SHA256 Checksum SHA256 Source Oct 16, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting