_                           _ 
            (_) |                         | |
   _ __ ___  _| |_ ___   ___ _ __ ___   __| |
  | '_ ` _ \| | __/ _ \ / __| '_ ` _ \ / _` |
  | | | | | | | ||  __/| (__| | | | | | (_| |
  |_| |_| |_|_|\__\___(_)___|_| |_| |_|\__,_|

A simple command line interface for basic mite tasks.

• mite. is an ingeniously sleek time tracking tool: http://mite.yo.lk
• mite.cmd is a command line interface for it: http://github.com/Overbryd/mite.cmd
  It provides a system wide command called mite.

I assume github is in your gem sources. You may need activesupport and activeresource too.

Note: On debian/ubuntu libopenssl-ruby is required.

You’ll need to configure the client prior using it.
To do this, you can just hammer into your console:

It will then generate a yml file in ~/.mite.yml with your account information.

The configure command also tries to install the bash auto completion hook into the following files: ~/.bash_completion, ~/.bash_profile, ~/.bash_login, ~/.bashrc.

If your system doesn’t support one of the files above, install the hook by yourself.
In order to work as expected it needs bash to be configured for auto completion.
This is actually quite easy, just append this line to your bash config file.

You could use this command as an example (replace .bash_login with your bash configuration file):

Append a + to the start time and it will start the tracker.

The most convenient syntax to set the start time is h:mm. So it will accept all these kinds of values: 1:15, 0:01, 24:00.

Short-hand for hours:

• 3+ will set the start time to 3 hours, and start the tracker
• 3.5 will set it to 3 hours 30 minutes
• 0.25+ will make you look like a floating-point fetish, and start the tracker

This will start a timer for the project World Domination.

The time entry created by this command, is made for the project HugEveryone and is set to 15 minutes. No tracker will be started.

Start a time entry for the project HugEveryone with the service Love and set it to 1 hour. The tracker will be started, because of the start time argument was suffixed with a +.

If a project or a service doesn’t exist it will be created.
You can omit one/some of the arguments, namely: project name, service name, note or start time. But they have to be in order. So you can’t set a service name unless you specify a project. This will be fixed in future releases, till then, the arguments rely on their order.

This is very nifty. (But maybe you should read the After Installation Instructions before.)
The client was designed to save keystrokes, so I’ve baked in a very handy auto-completion feature. It even ignores the typed case.

Try this:

It will try to auto-complete your projects.

It will try to auto-complete your services.

It will try to auto-complete common times!

It will try to auto-complete your notes!

The auto-completion feature creates a cache in ~/.mite.cache, if you want to rebuild this cache just hit:

$ mite rebuild-cache

$ mite start

This little cutey will start today’s last time entry, if there is one.

This will just stop the current timer. (If you like you can use `mite pause` or `mite lunch` too)

This will generate a report of today’s activity, summarizing your earnings at the bottom.

This will generate a report of yesterday’s activity, summarizing your earnings and the total time at the bottom.
Also works using this_week, last_week, this_month, last_month as argument.

If there is a running timer, it will output it. Otherwise you should better not listen to it.

Just create a new time entry and start tracking it.

Opens your mite account in a new browser window (Max OSX only) or prints the url to your account.

Your problems are no longer “problems”! They are called issues now, and github has the solution.

If you want to tell me an idea, I’ll happily take care of them in the issues tracker: http://github.com/Overbryd/mite.cmd/issues