This CLI tool lets you enter and search for any generic inventory with an extreme bias toward data entry speed. Super handy for tracking lots of your junk.
After cloning this repository and having Node.js version 10 or greater installed, cd into the root of this repository and run:
npm install
The CLI supports 2 commands: add and search.
Search your inventory based on keyword matching or location. You can then select matching hits to get the current locations and quantities.
Run search.(sh/bat) depending on your OS and follow prompts. Search for exit
to quit the program.
Adding inventory is intended for speed over extreme precision, so only a (long, keyword-based) name, location and quantity is recorded for each item. When naming the item, think about what keywords you'd search for when finding it later.
Run add.(sh/bat) depending on your OS and follow prompts. Typing exit
for an item name will quit the program.
Every item must be in a location, but your location can also be an item. For example, let's say you have a hammer
located in bin B1
, so you add the hammer item as such. If you then add B1
as an item itself, you can specify it's location in the Attic
. Adopting your own nested location scheme will allow you to find anything globally in a consistent way. Future versions of this tool will figure out the entire location hierarchy so this nesting pattern is highly encouraged.
If certain patterns reoccur across multiple item entries (such as locations B1
, then B2
), you may get pre-filled name and location suggestions (such as B3
). Press nothing but enter when appropriate to accept suggestions and zoom through data entry.
All of your inventory is stored in the inventory.json
file next to this Readme. Backup this file on occassion to ensure you don't lose valuable time.
While strict deletion isn't supported, you can always add an existing item by exact name and set it's quantity to zero.