Skip to main content

tag and organize your projects

Project description


DECREASES file tree complexity
INCREASES your Productivity

Joetags is a cli app to organize projects in a meaningful way for humans and machines You can Tag all your projects/directories to easily find them inside huge parent directories.
A branch of a branch of a branch of a branch is history.

Projects are Complex and not Black and White, they can be written in a particular language, be artistic at the same time, and made for a specific client. They can be about biology while being about chemics. The world is sometimes more complex than it seems. But Directory Trees force us to classify projects with just one property.

However with joetags you can add as many tags to directories as you want and easily find stuff. Aditionally labeled projects/directories can be made more accessible to automated processes.


Install and update using pip:

pip install joetags

How Joetags improves Working

Before using Joetags you may have a file tree like this:

  • User/projects/py
  • User/projects/py/ml
  • User/projects/py/bots
  • User/projects/py/art
  • User/projects/go
  • User/projects/go/hardware
  • User/projects/php


  • User/projects

where all your projects are live! Simply search py for all py tagged projects or search py|php to get all py or php tagged projects

How to search for directories

joetags search 'expr'

expressions can have unions:| intersections:& and can be negated:!


  • python|(php&machine_learning): finds all python projects or php machine learning_projects
  • python&!utility: all python projects not tagged with utility finds

How to Write .joetag File

Tags can use all letters, numbers and underscores and have to begin with a letter Tagnames can be followed by a Groupname (same syntax) seperated by :



Just type joetags add followed by a directory to easily add tags

Why are tags and groups handled the same in search

joetag search 'socialmedia'

does not care if socialmedia is a tag or a group, why is that?

groups may be tags for other groups: if socialmedia is a group in one place it could be a tag in another place


however it mustn't only have one 'parent' group

socialmedia:social socialmedia:internet

can both coexist in joetags

While the same could be achived with less characters and no duplicates we root for easy usage and syntax

Project details

Download files

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

Files for joetags, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size joetags-0.2.1.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page