TIMEW(1)                         User Manuals                         TIMEW(1)

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:

       timew-annotate(1)
           Add annotation to intervals

       timew-cancel(1)
           Cancel time tracking

       timew-config(1)
           Get and set Timewarrior configuration

       timew-continue(1)
           Resume tracking of existing interval

       timew-day(1)
           Display day chart

       timew-delete(1)
           Delete intervals

       timew-diagnostics(1)
           Show diagnostic information

       timew-export(1)
           Export tracked time in JSON

       timew-extensions(1)
           List available extensions

       timew-get(1)
           Display DOM values

       timew-help(1)
           Display help

       timew-join(1)
           Join intervals

       timew-lengthen(1)
           Lengthen intervals

       timew-modify(1)
           Change start or end time of an interval

       timew-month(1)
           Display month chart

       timew-move(1)
           Change interval start-time

       timew-report(1)
           Run an extension report

       timew-resize(1)
           Set interval duration

       timew-retag(1)
           Replace tags in intervals

       timew-shorten(1)
           Shorten intervals

       timew-show(1)
           Display configuration

       timew-split(1)
           Split intervals

       timew-start(1)
           Start time tracking

       timew-stop(1)
           Stop time tracking

       timew-summary(1)
           Display a time-tracking summary

       timew-tag(1)
           Add tags to intervals

       timew-tags(1)
           Display a list of tags

       timew-track(1)
           Add intervals to the database

       timew-undo(1)
           Undo Timewarrior commands

       timew-untag(1)
           Remove tags from intervals

       timew-week(1)
           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 (C) 2015 - 2018 T. Lauf, P. Beckingham, F. Hernandez.
       Timewarrior is distributed under the MIT license.  See
       <https://www.opensource.org/licenses/mit-license.php> 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
       <support@gothenburgbitfactory.org>

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)

timew 1.7.0-dev                   2023-12-30                          TIMEW(1)