---
name: "timew"
section: "1"
platform: "linux"
package: "timew"
version: "1.9.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/timew"
---

# timew(1)

a command line time tracker

## 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)](/timew-annotate/1.md)

Add annotation to intervals

[**timew-cancel**(1)](/timew-cancel/1.md)

Cancel time tracking

[**timew-config**(1)](/timew-config/1.md)

Get and set Timewarrior configuration

[**timew-continue**(1)](/timew-continue/1.md)

Resume tracking of existing interval

[**timew-day**(1)](/timew-day/1.md)

Display day chart

[**timew-delete**(1)](/timew-delete/1.md)

Delete intervals

[**timew-diagnostics**(1)](/timew-diagnostics/1.md)

Show diagnostic information

[**timew-export**(1)](/timew-export/1.md)

Export tracked time in JSON

[**timew-extensions**(1)](/timew-extensions/1.md)

List available extensions

[**timew-get**(1)](/timew-get/1.md)

Display DOM values

[**timew-help**(1)](/timew-help/1.md)

Display help

[**timew-join**(1)](/timew-join/1.md)

Join intervals

[**timew-lengthen**(1)](/timew-lengthen/1.md)

Lengthen intervals

[**timew-modify**(1)](/timew-modify/1.md)

Change start or end time of an interval

[**timew-month**(1)](/timew-month/1.md)

Display month chart

[**timew-move**(1)](/timew-move/1.md)

Change interval start-time

[**timew-report**(1)](/timew-report/1.md)

Run an extension report

[**timew-resize**(1)](/timew-resize/1.md)

Set interval duration

[**timew-retag**(1)](/timew-retag/1.md)

Replace tags in intervals

[**timew-shorten**(1)](/timew-shorten/1.md)

Shorten intervals

[**timew-show**(1)](/timew-show/1.md)

Display configuration

[**timew-split**(1)](/timew-split/1.md)

Split intervals

[**timew-start**(1)](/timew-start/1.md)

Start time tracking

[**timew-stop**(1)](/timew-stop/1.md)

Stop time tracking

[**timew-summary**(1)](/timew-summary/1.md)

Display a time-tracking summary

[**timew-tag**(1)](/timew-tag/1.md)

Add tags to intervals

[**timew-tags**(1)](/timew-tags/1.md)

Display a list of tags

[**timew-track**(1)](/timew-track/1.md)

Add intervals to the database

[**timew-undo**(1)](/timew-undo/1.md)

Undo Timewarrior commands

[**timew-untag**(1)](/timew-untag/1.md)

Remove tags from intervals

[**timew-week**(1)](/timew-week/1.md)

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  \<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-config/7.md), [**timew-dates**(7)](/timew-dates/7.md), [**timew-dom**(7)](/timew-dom/7.md), [**timew-durations**(7)](/timew-durations/7.md), [**timew-hints**(7)](/timew-hints/7.md), [**timew-ranges**(7)](/timew-ranges/7.md)