NAME
timew - a command line time tracker
SYNOPSIS
timew [--version|--help] timew [<command> [<arg>...]]
DESCRIPTION
Timewarrior is a command line time tracker. It allows you to easily track your time and generate summary reports.
This is a reference, not a tutorial. If you are looking for a tutorial, check the online documentation here:
https://timewarrior.net/docs/
When run without arguments or options, the default command is run, which indicates whether there is any active tracking, and if so, shows a summary and exits with code 0. If there is no active time tracking, exit code is 1.
OPTIONS
- --version
-
Display Timewarrior version information
- --help
-
Display Timewarrior usage information
TIMEWARRIOR COMMANDS
Timewarrior supports many commands. Alphabetically:
Add annotation to intervals
Cancel time tracking
Get and set Timewarrior configuration
Resume tracking of existing interval
Display day chart
Delete intervals
Show diagnostic information
Export tracked time in JSON
List available extensions
Display DOM values
Display help
Join intervals
Lengthen intervals
Change start or end time of an interval
Display month chart
Change interval start-time
Run an extension report
Set interval duration
Replace tags in intervals
Shorten intervals
Display configuration
Split intervals
Start time tracking
Stop time tracking
Display a time-tracking summary
Add tags to intervals
Display a list of tags
Add intervals to the database
Undo Timewarrior commands
Remove tags from intervals
Display week chart
MORE EXAMPLES
For examples please see the online documentation at:
<https://timewarrior.net/docs/>
Note that the online documentation is often more detailed and more current than this man page.
FILES
Non-Unix systems
~/.timewarrior/timewarrior.cfg
User configuration file.
~/.timewarrior/data/YYYY-MM.data
Time tracking data files.
Unix systems
${XDG_CONFIG_HOME:-$HOME/.config}/timewarrior/timewarrior.cfg
User configuration file if legacy ~/.timewarrior directory doesn’t exist.
${XDG_DATA_HOME:-$HOME/.local/share}/timewarrior/data/YYYY-MM.data
Time tracking data files if legacy ~/.timewarrior directory doesn’t exist.
CREDITS & COPYRIGHT
Copyright © 2015 - 2025 Gothenburg Bit Factory.
Timewarrior is distributed under the MIT license. See <https://opensource.org/license/mit> for more information.
FURTHER DOCUMENTATION
For more information regarding Timewarrior, see the following:
The official site at <https://timewarrior.net>
The official code repository at <https://github.com/GothenburgBitFactory/timewarrior>
You can contact the project by emailing <[email protected]>
REPORTING BUGS
Bugs in Timewarrior may be reported to the issue-tracker at <https://github.com/GothenburgBitFactory/timewarrior/issues>
SEE ALSO
timew-config(7), timew-dates(7), timew-dom(7), timew-durations(7), timew-hints(7), timew-ranges(7)