{ "info": { "author": "Shrikant Sharat & Trevor Bekolay", "author_email": "tbekolay@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "=================================\nti -- A silly simple time tracker\n=================================\n\n``ti`` is a small command line time-tracking application.\nSimple basic usage looks like this::\n\n $ ti on my-project\n $ ti fin\n\nYou can also give it human-readable times::\n\n $ ti on my-project 30mins ago\n\n``ti`` sports many other cool features. Read along to discover.\n\nWat?\n====\n\n``ti`` is a simple command line time tracker. It has been completely rewritten\nin Python (originally a bash script) and has (almost) complete test coverage. It\nis inspired by `timed `_, which is a nice project\nthat you should check out if you don't like ``ti``. ``ti`` also takes\ninspiration from the simplicity of `t `_.\n\nIf a time-tracking tool makes me think for more than 3-5 seconds, I lose my line\nof thought and forget what I was doing. This is why I created ``ti``. With\n``ti``, you'll be as fast as you can type, which you should be good with anyway.\n\nThe most important part about ``ti`` is that it provides just a few commands to\nmanage your time-tracking and then gets out of your way.\n\nAll data is saved in a JSON file ,``~/.ti-sheet``. (This can be changed using the\n``$SHEET_FILE`` environment variable.) The JSON is easy to access and can be\nprocessed into other more stylized documents. Some ideas:\n\n- Read your JSON file to generate beautiful HTML reports.\n- Build monthly statistics based on tags or tasks.\n- Read your currently working project and display it in your terminal prompt.\n Maybe even with the number of hours you've been working.\n\nIt's *your* data.\n\nOh and by the way, the source is a fairly small Python script, so if you know\nPython, you may want to skim over it to get a better feel of how it works.\n\n*Note*: If you have used the previous bash version of ``ti``, which was horribly\ntied up to only work on Linux, you might notice the lack of plugins in this\nPython version. I am not really missing them, so I might not add them. If anyone\nhas any interesting use cases for it, I'm willing to consider.\n\nUsage\n=====\n\nHere's the minimal usage style::\n\n $ ti on my-project\n Start working on my-project.\n\n $ ti status\n You have been working on my-project for less than a minute.\n\n $ ti fin\n So you stopped working on my-project.\n\n``on`` and ``fin`` can take a time (format described further down) at which to\napply the action::\n\n $ ti on another-project 2 hours ago\n Start working on another-project.\n\n $ ti s\n You have been working on another-project for about 2 hours.\n\n $ ti fin 30 minutes ago\n So you stopped working on another-project.\n\nAlso illustrating in the previous example is short aliases of all commands,\ntheir first letter. Like, ``s`` for ``status``, ``o`` for ``on``,\n``f`` for ``fin``, etc.\n\nPut brief notes on what you've been doing::\n\n $ ti note waiting for Napoleon to take over the world\n $ ti n another simple note for demo purposes\n\nTag your activities for fun and profit::\n\n $ ti tag imp\n\nGet a log of all activities with the ``log`` (or ``l``) command::\n\n $ ti log\n\nCommand reference\n=================\n\nRun ``ti -h`` (or ``--help`` or ``help`` or just ``h``)\nto get a short command summary of commands.\n\n``on``\n------\n\n- Short: ``o``\n- Syntax: ``ti (o|on) [