Doug CircleCI cargo-badge

A time tracking command-line utility

Why?

To have a time tracker that's not inhibited by slow language startup times.

Install

brew

brew install getdoug/doug/doug

cargo

cargo install doug

Bash completions

doug generate-completions --shell bash > $(brew --prefix)/etc/bash_completion.d/doug.bash

Usage

``` USAGE: doug [FLAGS]

FLAGS: -p, --path Path to load settings file from. (default: ~/.doug/settings.json) -h, --help Prints help information -V, --version Prints version information

SUBCOMMANDS: start Track new or existing project status Display elapsed time, start time, and running project name stop Stop any running projects cancel Stop running project and remove most recent time interval restart Track last running project log Display time intervals across all projects report Display aggregate time from projects amend Change name of currently running project edit Edit last frame or currently running frame settings configure doug settings generate-completions Generate completions delete Delete all intervals for project ```

start

``` Track new or existing project

USAGE: doug start

FLAGS: -h, --help Prints help information

ARGS: project to track ```

status

``` Display elapsed time, start time, and running project name

USAGE: doug status [FLAGS]

FLAGS: -h, --help Prints help information -s, --simple Print running project name or nothing if there isn't a running project. ```

stop

``` Stop any running projects

USAGE: doug stop

FLAGS: -h, --help Prints help information ```

cancel

``` Stop running project and remove most recent time interval

USAGE: doug cancel

FLAGS: -h, --help Prints help information ```

restart

``` Track last running project

USAGE: doug restart

FLAGS: -h, --help Prints help information ```

log

``` Display time intervals across all projects

USAGE: doug log

FLAGS: -h, --help Prints help information ```

report

``` Display aggregate time from projects

USAGE: doug report [FLAGS] [OPTIONS]

FLAGS: -d, --day Limit report to past day. Use multiple to increase interval. -h, --help Prints help information -m, --month Limit report to past month. Use multiple to increase interval. -w, --week Limit report to past week. Use multiple to increase interval. -y, --year Limit report to past year. Use multiple to increase interval.

OPTIONS: -f, --from Date when report should start (e.g. 2018-1-1) -t, --to Date when report should end (e.g. 2018-1-20) ```

amend

``` Change name of currently running project

USAGE: doug amend

FLAGS: -h, --help Prints help information

ARGS: new project name ```

edit

``` Edit last frame or currently running frame

USAGE: doug edit [OPTIONS]

FLAGS: -h, --help Prints help information

OPTIONS: -e, --end ending date -s, --start starting date ```

settings

``` configure doug settings

USAGE: doug settings [FLAGS] [OPTIONS]

FLAGS: -c, --clear
clear settings file

-h, --help     
        Prints help information

OPTIONS: -p, --path
path to store data file. this only affects the data file location. settings are stored in $HOME. ```

delete

``` Delete all intervals for project

USAGE: doug delete

FLAGS: -h, --help Prints help information

ARGS: new project name ```

merge

``` Merge period files

USAGE: doug merge [FLAGS]

FLAGS: --dry-run don't modify period file -h, --help Prints help information

ARGS: path to period file to merge ```

Prior Art