Cytime

Time tracking in the command line. Fast, simple and minimalistic.

Installation

npm install -g cytime

Aliases (optional)

To write less and log with less effort, add some aliases to your shell config file (e.g. ~/.bashrc or ~/.zshrc) and add the following lines:

# Time tracking with cytime
alias list='cytime list' # show week (default: current week)
alias in='cytime in' # log in
alias out='cytime out' # log out
alias pop='cytime pop' # delete entry (default: last entry)

Usage

| Command | Description | Alias * | | ------------ | ----------------------- | -------- | | cytime | Show current week | list | | cytime in | Start working (log in) | in | | cytime out | Start working (log out) | out | | cytime pop | Delete last entry | pop |

* Alias is optional

Examples

Logging

# log in (start working)
cytime in

# log out (stop working)
cytime out

Show week

# show current week
cytime list

# show previous week
cytime list prev

Manipulate time manually

# log in today at 8am
cytime in 08:00

# log out today at 5pm
cytime out 17:00

# log in on 2020-01-01 at 8am
cytime in 08:00 --day 11.11.2024

Delete logs

# delete last entry
cytime pop

# delete last 3 entries
cytime pop 3

Next steps

• [ ] Make it possible to use day, day and month or full day for the day attribute
• [ ] Add support for "yesterday" for day attribute
• [ ] Add support for "monday", "tuesday", etc. for day attribute (takes the last monday, tuesday, etc.)
• [ ] Add support for logging with positionals for day cytime in 08:00 2020-01-01
• [ ] Flat log file, but separated by weeks
• [ ] use json file instead of txt file
• [ ] Timestamps in logfiles
• [ ] Add undo command