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

Full-screen terminal interface for Taskwarrior. Version 2.3.4 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:vit
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install vit
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install vit
```

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

### Linux

- apk (92%):

```sh
sudo apk add vit
```

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

- Debian apt (92%):

```sh
sudo apt install vit
```

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

- dnf (92%):

```sh
sudo dnf install vit
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#vit
```

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

- pacman (92%):

```sh
sudo pacman -S vit
```

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

- zypper (92%):

```sh
sudo zypper install vit
```

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

## Package facts

- **Package key:** brew:vit
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/vit>
- **Version:** 2.3.4
- **Source summary:** Full-screen terminal interface for Taskwarrior
- **Homepage:** <https://github.com/vit-project/vit>
- **Repository:** <https://github.com/vit-project/vit>
- **Upstream docs:** <https://github.com/vit-project/vit#readme>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/1c/11/5a62bb49c3f5086d0e3eb85cb66eae9c2cc49123b9eb9dadfa032ea9c67a/vit-2.3.4.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- vit (cli)
- vit (alias)

## Dependencies

- python@3.14
- task

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

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

VIT, short for Visual Interactive Taskwarrior, is a full-screen terminal interface for Taskwarrior. It gives Taskwarrior users a curses-style task list with vi-like navigation, customizable key bindings, colorized columns, themes, formatters, and integrations with Taskwarrior reports.

### Project history

VIT predates the current vit-project GitHub organization. The Taskwarrior site announced VIT 1.2 beta1 in February 2014 as a Taskwarrior front end with user-defined shortcuts, external-command integration, improved prompt navigation, and Taskwarrior-oriented key changes. VIT 1.2 was released in April 2014, with Scott Kostyshak listed as the contact, and reached Homebrew in June 2014.

The current README preserves the project's older lineage with a tribute to Steve Rader, saying vit is preserved, maintained, and continued because of his work. The modern 2.x repository was created in September 2016 and moved VIT into a Python 3-era codebase. Its GitHub releases show v2.0.0 in September 2019, v2.1.0 in February 2021, v2.2.0 in April 2022, v2.3.0 in April 2023, and v2.3.4 in March 2026.

### Adoption history

VIT's adoption follows Taskwarrior's own power-user community. It became attractive to users who liked Taskwarrior's data model and command-line flexibility but wanted a persistent, keyboard-driven overview for day-to-day task triage.

The June 2014 Taskwarrior news item announcing Homebrew availability is a useful adoption marker: it put VIT into the macOS package-manager path alongside Taskwarrior itself. Later Linux distribution packages extended the same pattern for users who wanted a packaged TUI rather than a custom script around `task`.

### How it is used

A typical user runs `vit` to open a full-screen view over Taskwarrior's task database, then uses vi-like movement, commands, filters, and report views to inspect and modify tasks. The README recommends `vit --help`, in-application `:help`, and customization through the VIT user directory.

Customization is central to VIT's niche. The 2.x customization documentation says VIT looks for a user directory via `VIT_DIR`, `~/.vit`, or an XDG config directory, and supports custom config.ini settings, themes, formatters, keybindings, external refresh hooks, and Taskwarrior configuration overrides.

### Why package nerds care

VIT matters to package nerds because it is a classic terminal productivity companion package: not the task database itself, but the TUI that makes the database comfortable for daily use. Its design keeps Taskwarrior as the source of truth while giving users a fast, scriptable, no-mouse interface.

It also documents the evolution of Taskwarrior's ecosystem from core CLI to separately packaged tools. The package sits beside newer TUIs, but remains historically important as one of the long-running visual interfaces for Taskwarrior.

### Timeline

- 2013: Steve Rader, credited by the project as an important collaborator, died in May.
- 2014: VIT 1.2 beta1 announced in February; VIT 1.2 released in April; Homebrew availability announced in June.
- 2016: Current vit-project/vit repository created.
- 2019: v2.0.0 released for the modern Python-based line.
- 2021: v2.1.0 released.
- 2022: v2.2.0 released.
- 2023: v2.3.0 released.
- 2026: v2.3.4 released.

### Related projects

- VIT is tightly coupled to Taskwarrior. Related tools in the same ecosystem include Taskwarrior hooks, Taskserver, Timewarrior, tasksh, and newer Taskwarrior TUIs such as taskwarrior-tui.

### Sources

- <https://api.github.com/repos/vit-project/vit>
- <https://api.github.com/repos/vit-project/vit/releases?per_page=10>
- <https://github.com/vit-project/vit>
- <https://github.com/vit-project/vit/blob/2.x/CUSTOMIZE.md>
- <https://taskwarrior.org/news/news.20140220/>
- <https://taskwarrior.org/news/news.20140406/>
- <https://taskwarrior.org/news/news.20140607/>


## 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: $VIT_DIR/config.ini, ~/.vit/config.ini, $XDG_CONFIG_HOME/vit/config.ini
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** vit
- **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 - vit - 2.3.3-1: normalized package name match | Debian stable package indexes: vit from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | full-screen terminal interface for Taskwarrior | https://github.com/vit-project/vit
- Nix - vit: normalized package name match | nixpkgs package indexes: pkgs/by-name/vi/vit/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - vit - 2.3.2-1: normalized package name match | Ubuntu 24.04 LTS package indexes: vit from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | full-screen terminal interface for Taskwarrior | https://github.com/vit-project/vit
- apk - vit - 2.3.2-r2: normalized package name match | Alpine Linux edge package indexes: vit from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Lightweight, fast, curses-based front end to Taskwarrior | https://github.com/vit-project/vit
- apk - vit-pyc - 2.3.2-r2: normalized package name match | Alpine Linux edge package indexes: vit-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for vit | https://github.com/vit-project/vit
- dnf - vit - 2.3.4-2.fc45: normalized package name match | Fedora Rawhide package metadata: vit from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Visual Interactive Taskwarrior full-screen terminal interface | https://github.com/scottkosty/vit
- pacman - vit - 2.3.4-1: normalized package name match | Arch Linux sync databases: vit from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Terminal interface for Taskwarrior with Vim key bindings and colorization | https://github.com/vit-project/vit
- zypper - vit - 2.3.4-1.1: normalized package name match | openSUSE Tumbleweed package metadata: vit from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Visual Interactive Taskwarrior full-screen terminal interface | https://github.com/scottkosty/vit
- MacPorts - vit: normalized package name match | MacPorts ports tree: office/vit/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [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.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [taskwarrior-tui](https://www.automicvault.com/pkg/brew/taskwarrior-tui/) - Shares av.db curated category or tags: cli, productivity, task-management, taskwarrior, tui.
- [ttdl](https://www.automicvault.com/pkg/brew/ttdl/) - Shares av.db curated category or tags: cli, productivity, task-management, terminal.
- [pter](https://www.automicvault.com/pkg/brew/pter/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [taskline](https://www.automicvault.com/pkg/brew/taskline/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [taskopen](https://www.automicvault.com/pkg/brew/taskopen/) - Shares av.db curated category or tags: cli, productivity, task-management, taskwarrior.
- [tasksh](https://www.automicvault.com/pkg/brew/tasksh/) - Shares av.db curated category or tags: cli, productivity, task-management, taskwarrior.
- [todo-txt](https://www.automicvault.com/pkg/brew/todo-txt/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [todoist-cli](https://www.automicvault.com/pkg/brew/todoist-cli/) - Shares av.db curated category or tags: cli, productivity, task-management.
- [topydo](https://www.automicvault.com/pkg/brew/topydo/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, management, productivity, python, python-3-14.

## Combined YAML source

View the package source record on GitHub. [combined/vit.yml](https://github.com/automic-vault/db/blob/main/combined/vit.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
