About moro

Moro (DEPRECATED) is a command line tool for tracking work hours with minimal effort. Users run moro hi at the start of their workday to record clock-in time and moro bye at the end to record clock-out time. The tool then displays how many hours have been worked. The moro report command shows current day totals, while moro report --all displays historical records. Users can adjust forgotten entries by passing a time argument, such as moro hi 09:30. The name Moro means hello in Finnish. Installation is done globally via npm or yarn, requiring Node.js version 10 or higher, with precompiled binaries also available for Linux, Mac, and Windows. Note that this project is deprecated and undergoing major changes, so documentation may be outdated and functionality may be unstable. Only the published NPM version is considered stable. Users should proceed with caution.

g

Published by

getmoro

Visit View Profile

README.md

View on GitHub

Moro (DEPRECATED / USE AT YOUR OWN RISK)

A command line tool for tracking work hours, as simple as it can get.

Demo

alt tag

Install

If you have node and npm

You need node version 10 or higher (we haven't tested lower versions)

To install just type this into command line:

npm install -g moro

# or if you are using yarn, it works too
yarn global add  moro

You are done installing Moro!

(alternative install method) Download the compiled binary file

We recommend installing moro using npm but if you don't have node and npm on your machine, you can download the executable files from releases page for Linux, Mac and Windows.

Remember to copy ./lib/config.json to your home directory and rename it to

~/.moro-config.json

Then you can copy the downloaded executable file to your path, for example to /bin and start using moro just like the nomral installation.

Update

npm update -g moro

Usage

Run moro hi when starting your working day. Moro registers that time as your clock in time.
Run moro bye when ending your working day. Moro Registers that time as your clock out time.

That's it! Moro prints on the screen how many hours you have worked.

Invoke $:moro report at any time to see how long you have worked on the current day.

To see the full report of previous days run moro report --all.

Learn more:

Those two steps above should be all you need to know about Moro, but there are 3 ways to learn more:

$: moro --help
See the documentation: link
Or check this screen recording: link

Frequently Asked Questions (FAQ)

Click to open FAQ

Q: I forgot to run moro in the morning, so my clock in time is not saved. Can I adjust it now? A: yes! for example, if you started work at 09:30 run $: moro hi 09:30

What does moro mean?

Moro means hello in Finnish.

Contributing

Open an issue, or make a pull request. We love contributions.

Development

Clone this repo, and then inside the folder run:

npm link

This will install moro globally but using the files inside the project folder. You can now change the files and run moro in your command line to see the effects.

To run tests

npm test

Code of conduct

Code is important but people are more important. If you like to contribute to Moro please read and follow our code of conduct found in this file: CODE_OF_CONDUCT.md