You're a prolific developer (or you want to be). Manage, keep track of, and show off your projects.

npm install projects
1 downloads in the last week
33 downloads in the last month


You're a prolific developer (or you want to be). Manage, keep track of, and show off your projects with ease.


$ npm install -g projects


Command Description
alias output shell aliases
clone git clone a project
each run a command in each project directory
edit edit projects files
gc compact the projects database
get get an attribute for a project
git-status git status across all repositories
git-unpushed display repositories with unpushed commits
github fill your projects database with your GitHub repositories
glob glob across all project directories
info show the JSON for a given project
json-in import your projects from plain JSON
json-out export your projects to plain JSON
open open a project's homepage
query query your projects
remind get a reminder of what you were last working on
set set an attribute to a given value for a project

Writing your own commands

Projects is primarily a framework for making it easy to execute actions on one or more of your projects. For example, you could write a command to check the clean/dirty status of all of your checked out git repositories and list the dirty ones.

If you have an executable file in your PATH that starts with projects- then you can execute it underneath projects (and you're encouraged to share them with others!)


$ alias p=projects
$ cat ~/.config/projects
username = beaugunderson

directory = ~/p

$ p info vim-scss-instead
  "name": "vim-scss-instead",
  "repository": "",
  "language": "VimL",
  "role": "creator",
  "released": true,
  "status": "inactive"

$ p set vim-scss-instead homepage
Set vim-scss-instead:homepage to ""
$ p open vim-scss-instead # opens a web browser to the homepage URL
$ p clone vim-scss-instead
Cloning into '/Users/beau/p/vim-scss-instead'...
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 5 (delta 0), reused 5 (delta 0)
Receiving objects: 100% (5/5), done.

$ p github
Adding vim-scss-instead
Adding vim-human-dates

$ p git-unpushed
node-helmsman: 6 commits ahead of origin
projects: 3 commits ahead of origin


  • Add ability to specify flag defaults in ~/.config/projects for each command
  • Modify node-helmsman so that it doesn't require() all files (and add ability to specify description, etc. from the helmsman object); this will be a large speed increase
  • Be as git-like as possible when the concepts are similar/the same to prevent having to learn a new way of doing things
  • Shell functions (pcd <project>, for example, will change the directory to a project's directory)
  • Flesh out the query API (by number of issues, by last update, by dirty status, by number of collaborators, number of npm stars, number of packages used, etc.)
  • Open a browser on Windows, Linux (just uses OS X open right now)
  • A web API and examples of what you'd do with it
  • Add GET/POST/DELETE/PUT to the web API and add the concept of a master repository?
  • More well-defined attributes
  • Think more about efficiency
  • Get more people to write commands
  • Talk to people about their workflows
  • Workflows for Alfred
npm loves you