taskwarrior-tui
: A terminal user interface for taskwarrior
kdheepak.com/taskwarrior-tui
https://kdheepak.com/taskwarrior-tui
![]() Bumps [peaceiris/actions-gh-pages](https://github.com/peaceiris/actions-gh-pages) from 3 to 4. <details> <summary>Release notes</summary> <p><em>Sourced from <a href="https://github.com/peaceiris/actions-gh-pages/releases">peaceiris/actions-gh-pages's releases</a>.</em></p> <blockquote> <h2>actions-github-pages v4.0.0</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v4.0.0/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.9.3</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.9.3/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.9.2</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.9.2/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.9.1</h2> <ul> <li>update deps</li> </ul> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.9.1/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.9.0</h2> <ul> <li>deps: bump node12 to node16</li> <li>deps: bump <code>@actions/core</code> from 1.6.0 to 1.10.0</li> </ul> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.9.0/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.8.0</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.8.0/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.7.3</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.7.3/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.7.2</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.7.2/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.7.1</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.7.1/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.7.0</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.7.0/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <p>Overviews:</p> <ul> <li>Add .nojekyll file by default for all branches (<a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/438">#438</a>) (079d483), closes <a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/438">#438</a></li> <li>Add destination_dir option (<a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/403">#403</a>) (f30118c), closes <a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/403">#403</a> <a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/324">#324</a> <a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/390">#390</a></li> <li>Add exclude_assets option (<a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/416">#416</a>) (0f5c65e), closes <a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/416">#416</a> <a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/163">#163</a></li> <li>exclude_assets supports glob patterns (<a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/417">#417</a>) (6f45501), closes <a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/417">#417</a> <a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/163">#163</a></li> </ul> <h2>actions-github-pages v3.6.4</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.6.4/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.6.3</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.6.3/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <h2>actions-github-pages v3.6.2</h2> <p>See <a href="https://github.com/peaceiris/actions-gh-pages/blob/v3.6.2/CHANGELOG.md">CHANGELOG.md</a> for more details.</p> <!-- raw HTML omitted --> </blockquote> <p>... (truncated)</p> </details> <details> <summary>Changelog</summary> <p><em>Sourced from <a href="https://github.com/peaceiris/actions-gh-pages/blob/main/CHANGELOG.md">peaceiris/actions-gh-pages's changelog</a>.</em></p> <blockquote> <h2><a href="https://github.com/peaceiris/actions-gh-pages/compare/v3.9.2...v3.9.3">3.9.3</a> (2023-03-30)</h2> <h3>docs</h3> <ul> <li>fix typo, bump hugo version (<a href="https://redirect.github.com/peaceiris/actions-gh-pages/issues/851">#851</a>) (<a href=" |
||
---|---|---|
.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/