# Install timewarrior with Homebrew, apk, apt, MacPorts, Nix, zypper, dnf, pacman

Command-line time tracking application. Version 1.9.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:timewarrior
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install timewarrior
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install timewarrior
```

  Evidence: MacPorts ports tree: office/timewarrior/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add timewarrior
```

  Evidence: Alpine Linux edge package indexes: timewarrior from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install timewarrior
```

  Evidence: Debian stable package indexes: timewarrior from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#timewarrior
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ti/timewarrior/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install timewarrior
```

  Evidence: openSUSE Tumbleweed package metadata: timewarrior from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

- dnf (92%):

```sh
sudo dnf install timew
```

  Evidence: Fedora Rawhide package metadata: timew from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- pacman (92%):

```sh
sudo pacman -S timew
```

  Evidence: Arch Linux sync databases: timew from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:timewarrior
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/timewarrior>
- **Version:** 1.9.1
- **Source summary:** Command-line time tracking application
- **Homepage:** <https://timewarrior.net/>
- **Repository:** <https://github.com/GothenburgBitFactory/timewarrior>
- **Upstream docs:** <https://timewarrior.net/docs>
- **License:** MIT
- **Source archive:** <https://github.com/GothenburgBitFactory/timewarrior/releases/download/v1.9.1/timew-1.9.1.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- timew (cli)
- timew (alias)

## Build dependencies

- asciidoctor
- cmake

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.9.1
- Local data: ok
- Upstream repository: https://github.com/GothenburgBitFactory/timewarrior
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

Timewarrior is a free, open-source command-line time-tracking application from the Gothenburg Bit Factory ecosystem, closely associated with Taskwarrior.

### Project history

Timewarrior began as a companion to Taskwarrior. The Taskwarrior project announced Timewarrior 0.9.5 alpha in June 2016, describing it as a tool intended to replace Taskwarrior's older `timesheet` command and add more reporting capability.

The 1.0.0 release followed in August 2016. The release announcement described Timewarrior as tracking time from the command line, generating reports, storing data locally in clear text, and integrating with Taskwarrior.

The official Timewarrior site now presents it as free and open-source software that tracks time from the command line. Its release archive shows continued maintenance through the 1.x series, including 1.5.0 in 2023, 1.7.x in 2023-2024, and 1.9.1 in 2025.

### Adoption history

Timewarrior's adoption is strongly tied to command-line productivity users who already use Taskwarrior or similar plain-text workflows. Its tutorials emphasize no initial setup beyond first-run data/config creation and simple commands for starting, stopping, tagging, and summarizing intervals.

The input package-manager metadata lists broad distribution across apk, Homebrew, Debian, Fedora, MacPorts, Nix, Arch, Ubuntu, and openSUSE, indicating unusually wide packaging for a terminal productivity tool.

### How it is used

Typical usage starts with `timew start`, `timew stop`, and `timew summary`, often with tags to classify tracked work. The docs also cover backfilled intervals with `timew track` and reporting features such as summaries and charts.

Timewarrior stores intervals and models open and closed time ranges; the official interval-behavior docs explain real and synthetic intervals, exclusions, and how an open interval is handled across excluded time.

### Why package nerds care

Timewarrior is significant in the package-nerd niche because it is a mature CLI productivity tool with local text-like data, scriptable commands, and a natural link to Taskwarrior hooks and workflows.

Its appeal is strongest for users who want time tracking to live in the terminal and package manager rather than in a hosted SaaS application.

### Timeline

- 2016-06: Timewarrior 0.9.5 alpha announced by Taskwarrior.
- 2016-08: Timewarrior 1.0.0 released.
- 2023-04: Timewarrior 1.5.0 released.
- 2025-08: Timewarrior 1.9.1 listed as the current release on the official site.

### Related projects

- Taskwarrior is Timewarrior's closest related project; official announcements describe Timewarrior as its companion and replacement for Taskwarrior's older timesheet command.
- The broader family includes Gothenburg Bit Factory command-line productivity projects.

### Sources

- <https://taskwarrior.org/news/news.20160620/ - official Taskwarrior news announcing Timewarrior 0.9.5 alpha and its companion role.>
- <https://taskwarrior.org/news/news.20160821/ - official Taskwarrior news announcing Timewarrior 1.0.0.>
- <https://timewarrior.net/ - official homepage describes current purpose and release.>
- <https://timewarrior.net/docs/interval_behavior/ - official docs describe interval storage and behavior.>
- <https://timewarrior.net/releases/ - official release archive lists 1.0.0 through 1.9.1 release dates.>
- <https://timewarrior.net/tutorial/first_light/ - official tutorial documents first-run setup.>
- input.source_facts.package-manager - package-manager availability lists apk, Homebrew, Debian, Fedora, MacPorts, Nix, Arch, Ubuntu, and openSUSE.


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.timewarrior/timewarrior.cfg
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** timewarrior
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - timewarrior - 1.7.1+ds.1-2: normalized package name match | Debian stable package indexes: timewarrior from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | feature-rich time tracking utility | https://timewarrior.net/
- Nix - timewarrior: normalized package name match | nixpkgs package indexes: pkgs/by-name/ti/timewarrior/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - timewarrior - 1.7.1+ds.1-2: normalized package name match | Ubuntu 24.04 LTS package indexes: timewarrior from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | feature-rich time tracking utility | https://timewarrior.net/
- apk - timewarrior - 1.7.1-r0: normalized package name match | Alpine Linux edge package indexes: timewarrior from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | command line time tracking and reporting | https://timewarrior.net
- apk - timewarrior-doc - 1.7.1-r0: normalized package name match | Alpine Linux edge package indexes: timewarrior-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | command line time tracking and reporting (documentation) | https://timewarrior.net
- zypper - timewarrior - 1.9.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: timewarrior from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Command line time tracker | https://timewarrior.net/
- MacPorts - timewarrior: normalized package name match | MacPorts ports tree: office/timewarrior/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- apk - timew - 1.4.3-r1: installed executable or alias match | Alpine Linux edge package indexes: timew from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Timewarrior is a command line time tracking application | https://taskwarrior.org/
- apk - timew-bash-completion - 1.4.3-r1: installed executable or alias match | Alpine Linux edge package indexes: timew-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Bash completions for timew | https://taskwarrior.org/
- apk - timew-doc - 1.4.3-r1: installed executable or alias match | Alpine Linux edge package indexes: timew-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Timewarrior is a command line time tracking application (documentation) | https://taskwarrior.org/
- dnf - timew - 1.9.1-1.fc44: installed executable or alias match | Fedora Rawhide package metadata: timew from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Timewarrior tracks and reports time | https://timewarrior.net/
- pacman - timew - 1.9.1-1: installed executable or alias match | Arch Linux sync databases: timew from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Timewarrior, A command line time tracking application | https://timewarrior.net/


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [asciidoctor](https://www.automicvault.com/pkg/brew/asciidoctor/) - Build dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [klog](https://www.automicvault.com/pkg/brew/klog/) - Shares av.db curated category or tags: cli, productivity, time-tracking.
- [watson](https://www.automicvault.com/pkg/brew/watson/) - Shares av.db curated category or tags: cli, productivity, time-tracking.
- [tock](https://www.automicvault.com/pkg/brew/tock/) - Shares av.db curated category or tags: cli, productivity, time-tracking.
- [utimer](https://www.automicvault.com/pkg/brew/utimer/) - Shares av.db curated category or tags: cli, productivity, time-tracking.
- [ata](https://www.automicvault.com/pkg/brew/ata/) - Shares av.db curated category or tags: cli, productivity, time-tracking.
- [cdargs](https://www.automicvault.com/pkg/brew/cdargs/) - Shares av.db curated category or tags: cli, productivity.
- [doxx](https://www.automicvault.com/pkg/brew/doxx/) - Shares av.db curated category or tags: cli, productivity.
- [eureka](https://www.automicvault.com/pkg/brew/eureka/) - Shares av.db curated category or tags: cli, productivity.

## Combined YAML source

View the package source record on GitHub. [combined/timewarrior.yml](https://github.com/automic-vault/db/blob/main/combined/timewarrior.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph