otty / apps
All apps/Timewarrior

Timewarrior

timewarrior

Timewarrior is a command line time tracker.

Runs as timew, timewarrior|macOS, Linux, Windows|timewarrior.net
Open form in Otty otty.toml

Command form

ai-draft · 4 tasks · 8 fields

Track and report time. Start, stop, track past intervals and summarise; hints such as :fill or :week can be typed into the date and range fields.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui timewarrior

timew start

Start tracking

Begin tracking now, or at an optional date, with tags.

Start trackingExample values, fixed in this page — nothing here reaches a terminal
Basic
Tags*
string
TasksEach one presets the form for one job
Start with tags
tags
ParametersOnly these flags are editable in the form
Start date/time
Optional, for example 8am.
string · positional 0
Tags
Tags to track.
string · positional 1 · repeatable

timew stop

Stop tracking

Stop all tracking, or only the given tags.

Stop trackingExample values, fixed in this page — nothing here reaches a terminal
Basic
Stop date/time
string
TasksEach one presets the form for one job
Stop everything
date
ParametersOnly these flags are editable in the form
Stop date/time
Optional.
string · positional 0
Tags to stop
Leave empty to stop all tracking.
string · positional 1 · repeatable

timew track

Add a past interval

Record a closed interval in the past.

Add a past intervalExample values, fixed in this page — nothing here reaches a terminal
Basic
Range*
string
Tags
string
TasksEach one presets the form for one job
Record an interval
rangetags
ParametersOnly these flags are editable in the form
Range
Closed interval, for example: 9am - 11am or :yesterday.
string · positional 0
Tags
Tags for the interval.
string · positional 1 · repeatable

timew summary

Summary

Table of tracked time, by default for today.

SummaryExample values, fixed in this page — nothing here reaches a terminal
Basic
Range*
:weekstring
Tags
string
TasksEach one presets the form for one job
This week
rangetags
ParametersOnly these flags are editable in the form
Range
Optional range hint, for example :week or :lastmonth.
string · positional 0
Tags
Filter by tags.
string · positional 1 · repeatable
SourcesEvery flag above is checked against these
man
timew start [<date>] [<tag>…​] Begins tracking using the current time with any specified set of tags. If a tag contains multiple words, therefore containing spaces, use quotes to surround the whole tag.
manual2026-10-27

timewarrior.net

man
timew stop [<date>] [<tag>…​] Stops tracking time. If tags are specified, then they are no longer tracked. If no tags are specified, all tracking stops.
manual2026-10-27

timewarrior.net

man
timew track <range> [<tag>…​] The track command is used to add tracked time in the past. $ timew track 9am - 11am 'Staff Meeting' Note that the track command expects a closed interval (start and end time), when recording.
manual2026-10-27

timewarrior.net

man
timew summary [<range>] [<tag>…​] Displays a table summarizing tracked time, by default for the current day. Accepts date ranges (or range hints) and tags, or IDs for filtering.
manual2026-10-27

timewarrior.net

Before it fills your prompt, Otty checks the installed timew against its version. A form that does not match your version is not offered.