{"id":13478065,"url":"https://github.com/kdheepak/taskwarrior-tui","last_synced_at":"2026-04-02T21:56:59.816Z","repository":{"id":36997296,"uuid":"281581923","full_name":"kdheepak/taskwarrior-tui","owner":"kdheepak","description":"`taskwarrior-tui`: A terminal user interface for taskwarrior","archived":false,"fork":false,"pushed_at":"2025-04-07T01:18:04.000Z","size":2013,"stargazers_count":1656,"open_issues_count":106,"forks_count":75,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-04-23T17:50:32.052Z","etag":null,"topics":["cli","rust","taskwarrior","tui","tui-rs"],"latest_commit_sha":null,"homepage":"https://kdheepak.com/taskwarrior-tui","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kdheepak.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["kdheepak"],"custom":["https://donate.stripe.com/8wM9E7bBO9ZsbGUdQR"]}},"created_at":"2020-07-22T05:18:43.000Z","updated_at":"2025-04-19T11:12:11.000Z","dependencies_parsed_at":"2024-05-05T19:24:02.036Z","dependency_job_id":"977feb5f-fbc7-4f09-9250-6d162af0b869","html_url":"https://github.com/kdheepak/taskwarrior-tui","commit_stats":{"total_commits":1170,"total_committers":34,"mean_commits":"34.411764705882355","dds":0.0675213675213675,"last_synced_commit":"a768ee4e8bfd227fe5662f83904827b3ecb16939"},"previous_names":[],"tags_count":162,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdheepak%2Ftaskwarrior-tui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdheepak%2Ftaskwarrior-tui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdheepak%2Ftaskwarrior-tui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdheepak%2Ftaskwarrior-tui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kdheepak","download_url":"https://codeload.github.com/kdheepak/taskwarrior-tui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253766543,"owners_count":21960936,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","rust","taskwarrior","tui","tui-rs"],"created_at":"2024-07-31T16:01:52.004Z","updated_at":"2026-04-02T21:56:59.811Z","avatar_url":"https://github.com/kdheepak.png","language":"Rust","funding_links":["https://github.com/sponsors/kdheepak","https://donate.stripe.com/8wM9E7bBO9ZsbGUdQR","https://github.com/sponsors/GothenburgBitFactory"],"categories":["Rust","cli","\u003ca name=\"todo-manager\"\u003e\u003c/a\u003eTodo managers","💻 Apps","Table of Contents"],"sub_categories":["📝 Productivity and Planning"],"readme":"# `taskwarrior-tui`\n\n\u003e [!IMPORTANT]\n\u003e [`taskwarrior` v3.x](https://github.com/GothenburgBitFactory/taskwarrior/releases/tag/v3.0.0) may break `taskwarrior-tui` features in unexpected ways. Please file a bug report if you encounter a bug.\n\u003e\n\u003e taskwarrior-tui [v0.25.4](https://github.com/kdheepak/taskwarrior-tui/releases/tag/v0.25.4) is the last version supporting taskwarrior v2.x as backend.\n\n[![CI](https://github.com/kdheepak/taskwarrior-tui/workflows/CI/badge.svg)](https://github.com/kdheepak/taskwarrior-tui/actions?query=workflow%3ACI)\n[![](https://img.shields.io/github/license/kdheepak/taskwarrior-tui)](https://github.com/kdheepak/taskwarrior-tui/blob/main/LICENSE)\n[![](https://img.shields.io/github/v/release/kdheepak/taskwarrior-tui)](https://github.com/kdheepak/taskwarrior-tui/releases/latest)\n[![](https://img.shields.io/static/v1?label=platform\u0026message=linux-64%20|%20osx-64%20|%20win-32%20|%20win-64\u0026color=lightgrey)](https://github.com/kdheepak/taskwarrior-tui/releases/latest)\n[![](https://img.shields.io/github/languages/top/kdheepak/taskwarrior-tui)](https://github.com/kdheepak/taskwarrior-tui)\n[![](https://img.shields.io/coveralls/github/kdheepak/taskwarrior-tui)](https://coveralls.io/github/kdheepak/taskwarrior-tui)\n[![](https://img.shields.io/badge/taskwarrior--tui-docs-red)](https://kdheepak.com/taskwarrior-tui)\n[![](https://img.shields.io/github/downloads/kdheepak/taskwarrior-tui/total)](https://github.com/kdheepak/taskwarrior-tui/releases/latest)\n\nA Terminal User Interface (TUI) for [Taskwarrior](https://taskwarrior.org/) that you didn't know you wanted.\n\n### Features\n\n- vim-like navigation\n- live filter updates\n- add, delete, complete, log tasks\n- multiple selection\n- tab completion\n- colors based on taskwarrior\n\n![](https://user-images.githubusercontent.com/1813121/159858280-3ca31e9a-fc38-4547-a92d-36a7758cf5dc.gif)\n\n### Showcase\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eDemo\u003c/b\u003e: (video)\u003c/summary\u003e\n\u003ca href=\"https://www.youtube.com/watch?v=0ZdkfNrIAcw\"\u003e\u003cimg src=\"https://img.youtube.com/vi/0ZdkfNrIAcw/0.jpg\" /\u003e\u003c/a\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eUser Interface\u003c/b\u003e: (gif)\u003c/summary\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/1813121/113251568-bdef2380-927f-11eb-8cb6-5d95b00eee53.gif\"\u003e\u003c/img\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eMultiple selection\u003c/b\u003e: (gif)\u003c/summary\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/1813121/113252636-4e7a3380-9281-11eb-821d-874c86d11105.gif\"\u003e\u003c/img\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003eTab completion\u003c/b\u003e: (gif)\u003c/summary\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/1813121/113711977-cfcb2f00-96a2-11eb-8b06-9fd17903561d.gif\"\u003e\u003c/img\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/1813121/152730495-f0abd6b9-d710-44e6-a7f9-c15a68cc8233.png\"\u003e\u003c/img\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/1813121/152730497-44ce00d1-3a7c-4658-80d1-4df8d161cab8.png\"\u003e\u003c/img\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/1813121/152730498-cd75efed-d2c0-48e6-b82f-594e0a2a5dff.png\"\u003e\u003c/img\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/1813121/152731028-7ec9b388-37f6-4aa1-994c-0e4e8e0c205a.png\"\u003e\u003c/img\u003e\n\u003c/details\u003e\n\n### Documentation\n\n\u003cdetails\u003e\n\u003csummary\u003eSee \u003ca href=\"https://kdheepak.com/taskwarrior-tui\"\nclass=\"uri\"\u003ehttps://kdheepak.com/taskwarrior-tui\u003c/a\u003e for\ndocumentation.\u003c/summary\u003e\n\u003cp\u003eSee \u003ca href=\"https://kdheepak.com/taskwarrior-tui/installation/\"\nclass=\"uri\"\u003ehttps://kdheepak.com/taskwarrior-tui/installation/\u003c/a\u003e for\ninstallation instructions for your platform.\u003c/p\u003e\n\u003cp\u003eSee \u003ca href=\"https://kdheepak.com/taskwarrior-tui/quick_start/\"\nclass=\"uri\"\u003ehttps://kdheepak.com/taskwarrior-tui/quick_start/\u003c/a\u003e to get\nstarted.\u003c/p\u003e\n\u003cp\u003eSee \u003ca href=\"https://kdheepak.com/taskwarrior-tui/troubleshooting/\"\nclass=\"uri\"\u003ehttps://kdheepak.com/taskwarrior-tui/troubleshooting/\u003c/a\u003e for\nlogs, timing checks, and debugging steps.\u003c/p\u003e\n\u003cp\u003eSee \u003ca href=\"https://kdheepak.com/taskwarrior-tui/configuration/keys\"\nclass=\"uri\"\u003ehttps://kdheepak.com/taskwarrior-tui/configuration/keys\u003c/a\u003e\nor \u003ca href=\"https://kdheepak.com/taskwarrior-tui/configuration/colors/\"\nclass=\"uri\"\u003ehttps://kdheepak.com/taskwarrior-tui/configuration/colors/\u003c/a\u003e\nfor customization options.\u003c/p\u003e\n\u003c/details\u003e\n\n### Installation\n\nUnless otherwise specified, you will need to install the latest version of `taskwarrior` first. See \u003chttps://taskwarrior.org/download/\u003e for more information.\n\nPre-compiled releases are available on the [GitHub repo](https://github.com/kdheepak/taskwarrior-tui):\n\n1. Download the tar.gz file for your OS from [the latest release](https://github.com/kdheepak/taskwarrior-tui/releases/latest).\n2. Unzip the tar.gz file\n3. Run with `./taskwarrior-tui`.\n\nSee \u003chttps://kdheepak.com/taskwarrior-tui/installation/\u003e on instructions for using package managers on various platforms.\n\nIf you are compiling from source, you'll need the most recent stable rust compiler.\n\n### Configuration\n\n`taskwarrior-tui` uses `taskwarrior`'s `.taskrc` for configuration.\n\nSee the documentation for more information:\n\n- \u003chttps://kdheepak.com/taskwarrior-tui/configuration/keys\u003e\n- \u003chttps://kdheepak.com/taskwarrior-tui/configuration/colors\u003e\n- \u003chttps://kdheepak.com/taskwarrior-tui/configuration/advanced/\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eHere is an example `.taskrc`\u003c/summary\u003e\n\n```.taskrc\n### taskwarrior configuration options\n\n# taskwarrior's configuration\ndata.location=.task\nverbose=affected,blank,context,edit,header,footnote,label,new-id,project,special,sync,recur\nuda.priority.values=H,M,,L\ncolor.alternate=\n\n# taskwarrior-tui reads color attributes from the following to display the same colors of tasks as the CLI\ncolor.tagged=black on rgb444\n\n# Remove age, tags from task next report.\n# taskwarrior-tui reads the labels and columns from these options to display tasks the same way taskwarrior does\nreport.next.labels=ID,Active,Age,Deps,P,Project,Tag,Recur,S,Due,Until,Description,Urg\nreport.next.columns=id,start.age,entry.age,depends,priority,project,tags,recur,scheduled.countdown,due.relative,until.remaining,description.truncated_count,urgency\nreport.next.filter=(status:pending or status:waiting) page:limit\n\n### taskwarrior-tui configuration options\n\nuda.taskwarrior-tui.keyconfig.done=x\nuda.taskwarrior-tui.keyconfig.delete=d\nuda.taskwarrior-tui.task-report.use-alternate-style=false\nuda.taskwarrior-tui.shortcuts.1=~/local/bin/task-sync.sh\nuda.taskwarrior-tui.report.next.filter=(status:pending or status:waiting)\n```\n\n\u003c/details\u003e\n\n### References / Resources\n\nIf you like `taskwarrior-tui`, please consider donating to\n\n- [`kdheepak`](https://github.com/sponsors/kdheepak)\n- [`@GothenburgBitFactory`](https://github.com/sponsors/GothenburgBitFactory)\n- and/or a charity of your choice.\n\n\u003cdetails\u003e\n\u003csummary\u003eAdditional resources\u003c/summary\u003e\n\u003cul\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/GothenburgBitFactory/taskwarrior\"\nclass=\"uri\"\u003ehttps://github.com/GothenburgBitFactory/taskwarrior\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/GothenburgBitFactory/libshared\"\nclass=\"uri\"\u003ehttps://github.com/GothenburgBitFactory/libshared\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/GothenburgBitFactory/timewarrior\"\nclass=\"uri\"\u003ehttps://github.com/GothenburgBitFactory/timewarrior\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/fdehau/tui-rs\"\nclass=\"uri\"\u003ehttps://github.com/fdehau/tui-rs\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/tui-rs-revival/ratatui\"\nclass=\"uri\"\u003ehttps://github.com/tui-rs-revival/ratatui\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/crossterm-rs/crossterm/\"\nclass=\"uri\"\u003ehttps://github.com/crossterm-rs/crossterm/\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/async-rs/async-std\"\nclass=\"uri\"\u003ehttps://github.com/async-rs/async-std\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/kkawakam/rustyline\"\nclass=\"uri\"\u003ehttps://github.com/kkawakam/rustyline\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/vit-project/vit\"\nclass=\"uri\"\u003ehttps://github.com/vit-project/vit\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/taskchampion/taskchampion/\"\nclass=\"uri\"\u003ehttps://github.com/taskchampion/taskchampion/\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdheepak%2Ftaskwarrior-tui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkdheepak%2Ftaskwarrior-tui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdheepak%2Ftaskwarrior-tui/lists"}