App::TimeTracker::Command::Core - App::TimeTracker Core commands
More commands are implemented in various plugins. Plugins might also alter and/or amend commands.
~/perl/Your-Project$ tracker start
Started working on Your-Project at 23:44:19
Start tracking the current project now. Automatically stop the previous task, if there was one.
~/perl/Your-Project$ tracker start --at 12:42
~/perl/Your-Project$ tracker start --at '2011-02-26 12:42'
Start at the specified time/datetime instead of now. If only a time is provided, the day defaults to today. See TT::DateTime in App::TimeTracker.
~/perl/Your-Project$ tracker start --project SomeProject
Use the specified project instead of the one determined by the current working directory.
~/perl/Your-Project$ tracker start --description "Solving nasty bug"
Supply some descriptive text to the task. Might be used by reporting plugins etc.
~/perl/Your-Project$ tracker start --tag RT1234 --tag testing
A list of tags to add to the task. Can be used by reporting plugins.
~/perl/Your-Project$ tracker stop
Worked 00:20:50 on Your-Project
Stop tracking the current project now.
Stop at the specified time/datetime instead of now.
~/perl/Your-Project$ tracker continue
Continue working on the previous task after a break.
~$ tracker start --project ExplainContinue --tag testing
Started working on ExplainContinue (testing) at 12:42
# ... time passes, it's now 13:17
~$ tracker stop
Worked 00:35:00 on ExplainContinue
# back from lunch at 13:58
~$ tracker continue
Started working on ExplainContinue (testing) at 13:58
same as start
~/perl/Your-Project$ tracker append
Start working on a task at exactly the time you stopped working at the previous task.
~$ tracker start --project ExplainAppend --tag RT1234
Started working on ExplainAppend (RT1234) at 14:23
# ... time passes (14:46)
~$ tracker stop
Worked 00:23:00 on ExplainAppend (RT1234)
# start working on new ticket
# but forgot to hit start (14:53)
~$ tracker append --tag RT7890
Started working on ExplainAppend (RT7890) at 14:46
~/perl/Your-Project$ tracker current
Working 00:20:17 on Your-Project
Display what you're currently working on, and for how long.
~/perl/Your-Project$ tracker worked [SPAN]
Report the total time worked in the given time span, maybe limited to some projects.
Begin of reporting interval, defaults to first day of current month.
End of reporting interval, default to DateTime->now.
Automatically set --from and --to to the calculated values
~/perl/Your-Project$ tracker worked --this week
~/perl/Your-Project$ tracker worked --last day (=yesterday)
~$ tracker worked --last day --project SomeProject
~/perl/Your-Project$ tracker report
Print out a detailed report of what you did. All worked times are summed up per project (and optionally per tag)
The same options as for worked, plus:
~/perl/Your-Project$ tracker report --last month --detail tag
Valid options are: tag, description
Will print the tag(s) and/or description.
Also calc sums per tag.
~/perl/Your-Project$ tracker report --last month --verbose
Lists all found trackfiles and their respective duration before printing out the report.
~/perl/Your-Project$ tracker list
Print out a detailed report of what you did in a tabular format including start and stop times.
The same options as for report
~/perl/Your-Project$ tracker init
Initialize current directory as a project in which to track time. This step is required before one can use time tracking commands such as start and stop. The initialization step creates a rather empty .tracker.json config file in the current directory.
~/perl/Your-Project$ tracker show_config
Dump the config that's valid for the current directory. Might be handy when setting up plugins etc.
~/perl/Your-Project$ tracker plugins
List all installed plugins (i.e. stuff in App::TimeTracker::Command::*)
~/perl/Your-Project$ tracker recalc_trackfile --trackfile 20110808-232327_App_TimeTracker.trc
Recalculates the duration stored in an old trackfile. Might be useful after a manual update in a trackfile. Might be unnecessary in the future, as soon as task duration is always calculated lazily.
Only the name of the trackfile is required, but you can also pass in the absolute path to the file. Broken trackfiles are sometimes reported during report.
~/perl/Your-Project$ tracker commands
List all available commands, based on your current config.
Thomas Klausner <firstname.lastname@example.org>
This software is copyright (c) 2011 - 2021 by Thomas Klausner.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install App::TimeTracker, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell
For more information on module installation, please visit the detailed CPAN module installation guide.