0.1.0 • Published 6 months ago
@lmoesle/time-tracking-utility v0.1.0
About The Project
This is a simple command line application that shows your timetracking entries from clockify.
@lmoesle/time-tracking-utility view -p this-week
Date | Start | End | Pause | Duration | Client | Description
-----------+----------+----------+-------------+-------------+--------------------------------+--------------------------------
2023-11-05 | 14:00:00 | 15:30:00 | 0 h 0 min | 1 h 30 min | | Personal Projects,
-----------+----------+----------+-------------+-------------+--------------------------------+--------------------------------
Total: 1 h 30 min
Built With
- TypeScript
- Commander.js
Getting started
npm install
# build
npm run build
# run
npm start hello
Documentation
Usage: index [options] [command]
_____ _ _____ _ _ _ _ _ _ _
|_ _|_|_____ ___ |_ _|___ ___ ___| |_|_|___ ___ _ _| |_|_| |_| |_ _ _
| | | | | -_| | | | _| .'| _| '_| | | . | | | | _| | | | _| | |
|_| |_|_|_|_|___| |_| |_| |__,|___|_,_|_|_|_|_ | |___|_| |_|_|_|_| |_ |
|___| |___|
Options:
-V, --version output the version number
-h, --help display help for command
Commands:
view [options] View the time entries for the defined day, week or month
help [command] display help for command
Installation
npm install -g @lmoesle/time-tracking-utility
Setup Clockify API Key
A clockify api key is required to use this tool. You can find your api key in your clockify profile settings.
You have to export the api key as an environment variable. You can do this by adding the following line to your
.bashrc
or .zshrc
file.
export clockifyApiKey=<your-clockify-api-key>
Usage
@lmoesle/time-tracking-utility view -p <time-period> -c <client>
# examples
@lmoesle/time-tracking-utility view -p today
@lmoesle/time-tracking-utility view -p yesterday
@lmoesle/time-tracking-utility view -p this-week
@lmoesle/time-tracking-utility view -p this-month
@lmoesle/time-tracking-utility view -p last-month
Options
Option | Description | Required |
---|---|---|
-p, --period | Time period to view | yes |
-c, --client | Client to view | no |
License
Distributed under the MIT.
0.1.0
6 months ago