taskwarrior-tui
: A terminal user interface for taskwarrior
kdheepak.com/taskwarrior-tui
https://kdheepak.com/taskwarrior-tui
![]() Bumps the cargo-dependencies group with 12 updates in the / directory: | Package | From | To | | --- | --- | --- | | [anyhow](https://github.com/dtolnay/anyhow) | `1.0.86` | `1.0.87` | | [clap](https://github.com/clap-rs/clap) | `4.5.7` | `4.5.17` | | [lazy_static](https://github.com/rust-lang-nursery/lazy-static.rs) | `1.4.0` | `1.5.0` | | [log](https://github.com/rust-lang/log) | `0.4.21` | `0.4.22` | | [regex](https://github.com/rust-lang/regex) | `1.10.5` | `1.10.6` | | [tokio](https://github.com/tokio-rs/tokio) | `1.38.0` | `1.40.0` | | [tokio-stream](https://github.com/tokio-rs/tokio) | `0.1.15` | `0.1.16` | | [ratatui](https://github.com/ratatui/ratatui) | `0.26.3` | `0.27.0` | | [unicode-truncate](https://github.com/Aetf/unicode-truncate) | `1.0.0` | `1.1.0` | | [uuid](https://github.com/uuid-rs/uuid) | `1.8.0` | `1.10.0` | | [versions](https://github.com/fosskers/rs-versions) | `6.2.0` | `6.3.2` | | [clap_complete](https://github.com/clap-rs/clap) | `4.5.5` | `4.5.26` | Updates `anyhow` from 1.0.86 to 1.0.87 - [Release notes](https://github.com/dtolnay/anyhow/releases) - [Commits](https://github.com/dtolnay/anyhow/compare/1.0.86...1.0.87) Updates `clap` from 4.5.7 to 4.5.17 - [Release notes](https://github.com/clap-rs/clap/releases) - [Changelog](https://github.com/clap-rs/clap/blob/master/CHANGELOG.md) - [Commits](https://github.com/clap-rs/clap/compare/clap_complete-v4.5.7...clap_complete-v4.5.17) Updates `lazy_static` from 1.4.0 to 1.5.0 - [Release notes](https://github.com/rust-lang-nursery/lazy-static.rs/releases) - [Commits](https://github.com/rust-lang-nursery/lazy-static.rs/compare/1.4.0...1.5.0) Updates `log` from 0.4.21 to 0.4.22 - [Release notes](https://github.com/rust-lang/log/releases) - [Changelog](https://github.com/rust-lang/log/blob/master/CHANGELOG.md) - [Commits](https://github.com/rust-lang/log/compare/0.4.21...0.4.22) Updates `regex` from 1.10.5 to 1.10.6 - [Release notes](https://github.com/rust-lang/regex/releases) - [Changelog](https://github.com/rust-lang/regex/blob/master/CHANGELOG.md) - [Commits](https://github.com/rust-lang/regex/compare/1.10.5...1.10.6) Updates `tokio` from 1.38.0 to 1.40.0 - [Release notes](https://github.com/tokio-rs/tokio/releases) - [Commits](https://github.com/tokio-rs/tokio/compare/tokio-1.38.0...tokio-1.40.0) Updates `tokio-stream` from 0.1.15 to 0.1.16 - [Release notes](https://github.com/tokio-rs/tokio/releases) - [Commits](https://github.com/tokio-rs/tokio/compare/tokio-stream-0.1.15...tokio-stream-0.1.16) Updates `ratatui` from 0.26.3 to 0.27.0 - [Release notes](https://github.com/ratatui/ratatui/releases) - [Changelog](https://github.com/ratatui/ratatui/blob/main/CHANGELOG.md) - [Commits](https://github.com/ratatui/ratatui/compare/v0.26.3...v0.27.0) Updates `unicode-truncate` from 1.0.0 to 1.1.0 - [Release notes](https://github.com/Aetf/unicode-truncate/releases) - [Changelog](https://github.com/Aetf/unicode-truncate/blob/master/CHANGELOG.md) - [Commits](https://github.com/Aetf/unicode-truncate/compare/v1.0.0...v1.1.0) Updates `uuid` from 1.8.0 to 1.10.0 - [Release notes](https://github.com/uuid-rs/uuid/releases) - [Commits](https://github.com/uuid-rs/uuid/compare/1.8.0...1.10.0) Updates `versions` from 6.2.0 to 6.3.2 - [Release notes](https://github.com/fosskers/rs-versions/releases) - [Changelog](https://github.com/fosskers/rs-versions/blob/master/CHANGELOG.md) - [Commits](https://github.com/fosskers/rs-versions/commits) Updates `clap_complete` from 4.5.5 to 4.5.26 - [Release notes](https://github.com/clap-rs/clap/releases) - [Changelog](https://github.com/clap-rs/clap/blob/master/CHANGELOG.md) - [Commits](https://github.com/clap-rs/clap/compare/clap_complete-v4.5.5...clap_complete-v4.5.26) --- updated-dependencies: - dependency-name: anyhow dependency-type: direct:production update-type: version-update:semver-patch dependency-group: cargo-dependencies - dependency-name: clap dependency-type: direct:production update-type: version-update:semver-patch dependency-group: cargo-dependencies - dependency-name: lazy_static dependency-type: direct:production update-type: version-update:semver-minor dependency-group: cargo-dependencies - dependency-name: log dependency-type: direct:production update-type: version-update:semver-patch dependency-group: cargo-dependencies - dependency-name: regex dependency-type: direct:production update-type: version-update:semver-patch dependency-group: cargo-dependencies - dependency-name: tokio dependency-type: direct:production update-type: version-update:semver-minor dependency-group: cargo-dependencies - dependency-name: tokio-stream dependency-type: direct:production update-type: version-update:semver-patch dependency-group: cargo-dependencies - dependency-name: ratatui dependency-type: direct:production update-type: version-update:semver-minor dependency-group: cargo-dependencies - dependency-name: unicode-truncate dependency-type: direct:production update-type: version-update:semver-minor dependency-group: cargo-dependencies - dependency-name: uuid dependency-type: direct:production update-type: version-update:semver-minor dependency-group: cargo-dependencies - dependency-name: versions dependency-type: direct:production update-type: version-update:semver-minor dependency-group: cargo-dependencies - dependency-name: clap_complete dependency-type: direct:production update-type: version-update:semver-patch dependency-group: cargo-dependencies ... Signed-off-by: dependabot[bot] <support@github.com> |
||
---|---|---|
.github | ||
.rpm | ||
completions | ||
docs | ||
snap | ||
src | ||
.editorconfig | ||
.envrc | ||
.gitignore | ||
.justfile | ||
.rustfmt.toml | ||
build.rs | ||
Cargo.lock | ||
Cargo.toml | ||
CHANGELOG.md | ||
LICENSE | ||
mkdocs.yml | ||
README.md | ||
rust-toolchain.toml |
taskwarrior-tui
Important
taskwarrior
v3.x may breaktaskwarrior-tui
features in unexpected ways. Please file a bug report if you encounter a bug.
A Terminal User Interface (TUI) for Taskwarrior that you didn't know you wanted.
Features
- vim-like navigation
- live filter updates
- add, delete, complete, log tasks
- multiple selection
- tab completion
- colors based on taskwarrior
Showcase
User Interface: (gif)

Multiple selection: (gif)

Tab completion: (gif)





Documentation
See https://kdheepak.com/taskwarrior-tui for documentation.
See https://kdheepak.com/taskwarrior-tui/installation/ for installation instructions for your platform.
See https://kdheepak.com/taskwarrior-tui/quick_start/ to get started.
See https://kdheepak.com/taskwarrior-tui/configuration/keys or https://kdheepak.com/taskwarrior-tui/configuration/colors/ for customization options.
Installation
Unless otherwise specified, you will need to install the latest version of taskwarrior
first. See https://taskwarrior.org/download/ for more information.
Pre-compiled releases are available on the GitHub repo:
- Download the tar.gz file for your OS from the latest release.
- Unzip the tar.gz file
- Run with
./taskwarrior-tui
.
See https://kdheepak.com/taskwarrior-tui/installation/ on instructions for using package managers on various platforms.
If you are compiling from source, you'll need to most recent stable rust compiler.
Configuration
taskwarrior-tui
uses taskwarrior
's .taskrc
for configuration.
See the documentation for more information:
- https://kdheepak.com/taskwarrior-tui/configuration/keys
- https://kdheepak.com/taskwarrior-tui/configuration/colors
- https://kdheepak.com/taskwarrior-tui/configuration/advanced/
Here is an example `.taskrc`
### taskwarrior configuration options
# taskwarrior's configuration
data.location=.task
verbose=affected,blank,context,edit,header,footnote,label,new-id,project,special,sync,recur
uda.priority.values=H,M,,L
color.alternate=
# taskwarrior-tui reads color attributes from the following to display the same colors of tasks as the CLI
color.tagged=black on rgb444
# Remove age, tags from task next report.
# taskwarrior-tui reads the labels and columns from these options to display tasks the same way taskwarrior does
report.next.labels=ID,Active,Age,Deps,P,Project,Tag,Recur,S,Due,Until,Description,Urg
report.next.columns=id,start.age,entry.age,depends,priority,project,tags,recur,scheduled.countdown,due.relative,until.remaining,description.truncated_count,urgency
report.next.filter=(status:pending or status:waiting) page:limit
### taskwarrior-tui configuration options
uda.taskwarrior-tui.keyconfig.done=x
uda.taskwarrior-tui.keyconfig.delete=d
uda.taskwarrior-tui.shortcuts.1=~/local/bin/task-sync.sh
uda.taskwarrior-tui.report.next.filter=(status:pending or status:waiting)
References / Resources
If you like taskwarrior-tui
, please consider donating to
kdheepak
@GothenburgBitFactory
- and/or a charity of your choice.
Additional resources
- https://github.com/GothenburgBitFactory/taskwarrior
- https://github.com/GothenburgBitFactory/libshared
- https://github.com/GothenburgBitFactory/timewarrior
- https://github.com/fdehau/tui-rs
- https://github.com/tui-rs-revival/ratatui
- https://github.com/crossterm-rs/crossterm/
- https://github.com/async-rs/async-std
- https://github.com/kkawakam/rustyline
- https://github.com/vit-project/vit
- https://github.com/taskchampion/taskchampion/