From fffdb955caa184ac0b5cb949981929681d1a508b Mon Sep 17 00:00:00 2001 From: Anurag Singh Date: Sun, 25 Oct 2026 09:16:40 +0530 Subject: [PATCH 1/2] docs: mention supported Taskwarrior versions in README Adds Compatibility section mapping Taskwarrior 3.x to TaskChampion and 2.x to Legacy TaskServer, matching in-app profile modes (Taskchampion v3 / TaskServer). Fixes #625 --- README.md | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index f72ab58e..77385f22 100644 --- a/README.md +++ b/README.md @@ -21,12 +21,13 @@ ## Table of Contents - [About](#about) +- [Compatibility](#compatibility) - [Screenshots](#screenshots) - [Built With](#built-with) - [Setup](#setup) - [Syncing](#syncing) - - [TaskChampion (recommended)](#taskchampion-recommended) - - [Legacy TaskServer](#legacy-taskserver) + - [TaskChampion (recommended) — Taskwarrior 3.x](#taskchampion-recommended) + - [Legacy TaskServer — Taskwarrior 2.x](#legacy-taskserver) - [Contributing](#contributing) - [Google Summer of Code](#google-summer-of-code) - [Community](#community) @@ -42,6 +43,17 @@ Taskwarrior is free and open-source software that manages your TODO list from th This project brings that workflow to mobile and desktop: manage your tasks, filter them, and keep them in sync across all your devices. +## Compatibility + +This app supports both Taskwarrior 2.x and 3.x workflows: + +| Taskwarrior CLI | Sync backend in this app | Server | +| --- | --- | --- | +| 3.x | TaskChampion (recommended) | Any TaskChampion sync server, e.g. [WingTask](https://app.wingtask.com/) or self-hosted [taskchampion-sync-server](https://github.com/GothenburgBitFactory/taskchampion-sync-server) | +| 2.x | Legacy TaskServer (`taskd`) | Self-hosted `taskd`, see [Legacy TaskServer](#legacy-taskserver) | + +Pick the profile mode that matches your Taskwarrior version: `Taskchampion (v3)` for 3.x, `TaskServer` for 2.x. +

Taskwarrior

@@ -100,15 +112,15 @@ your SDK matches the version in `.fvmrc`. See [SETUP.md](SETUP.md) for details. ## Syncing -The app supports two sync backends. TaskChampion is the modern one and is recommended for new setups. +The app supports two sync backends covering both Taskwarrior 2.x and 3.x. TaskChampion is the modern one and is recommended for new setups. ### TaskChampion (recommended) -The app syncs through TaskChampion. You can use [WingTask](https://app.wingtask.com/) as a hosted TaskChampion sync server to keep your tasks in sync across devices. Point the app at your server URL, client ID, and encryption secret. +The app syncs through TaskChampion for Taskwarrior 3.x workflows. You can use [WingTask](https://app.wingtask.com/) as a hosted TaskChampion sync server to keep your tasks in sync across devices. Point the app at your server URL, client ID, and encryption secret. You can also self-host [taskchampion-sync-server](https://github.com/GothenburgBitFactory/taskchampion-sync-server). ### Legacy TaskServer -TaskServer lets you share tasks across clients and devices, and keeps an automatic backup of your data. +TaskServer sync is for Taskwarrior 2.x workflows. It lets you share tasks across clients and devices, and keeps an automatic backup of your data. **Self-hosted TaskServer** From b5384003e394ad915dccb360e5cf7f64893581cf Mon Sep 17 00:00:00 2001 From: Anurag Singh Date: Sun, 25 Oct 2026 09:34:43 +0530 Subject: [PATCH 2/2] docs: narrow TaskServer compat to 2.6.2 per review Taskwarrior FAQ states Taskserver works only with 2.6.2. Also reword server copy instead of automatic backup and mark ogarcia/docker-taskd as archived upstream. --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 77385f22..6d606942 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ - [Setup](#setup) - [Syncing](#syncing) - [TaskChampion (recommended) — Taskwarrior 3.x](#taskchampion-recommended) - - [Legacy TaskServer — Taskwarrior 2.x](#legacy-taskserver) + - [Legacy TaskServer — Taskwarrior 2.6.2](#legacy-taskserver) - [Contributing](#contributing) - [Google Summer of Code](#google-summer-of-code) - [Community](#community) @@ -45,14 +45,14 @@ This project brings that workflow to mobile and desktop: manage your tasks, filt ## Compatibility -This app supports both Taskwarrior 2.x and 3.x workflows: +This app supports Taskwarrior 2.6.2 and 3.x workflows: | Taskwarrior CLI | Sync backend in this app | Server | | --- | --- | --- | | 3.x | TaskChampion (recommended) | Any TaskChampion sync server, e.g. [WingTask](https://app.wingtask.com/) or self-hosted [taskchampion-sync-server](https://github.com/GothenburgBitFactory/taskchampion-sync-server) | -| 2.x | Legacy TaskServer (`taskd`) | Self-hosted `taskd`, see [Legacy TaskServer](#legacy-taskserver) | +| 2.6.2 | Legacy TaskServer (`taskd`) | Self-hosted `taskd`, see [Legacy TaskServer](#legacy-taskserver) | -Pick the profile mode that matches your Taskwarrior version: `Taskchampion (v3)` for 3.x, `TaskServer` for 2.x. +Pick the profile mode that matches your Taskwarrior version: `Taskchampion (v3)` for 3.x, `TaskServer` for 2.6.2.

Taskwarrior @@ -112,7 +112,7 @@ your SDK matches the version in `.fvmrc`. See [SETUP.md](SETUP.md) for details. ## Syncing -The app supports two sync backends covering both Taskwarrior 2.x and 3.x. TaskChampion is the modern one and is recommended for new setups. +The app supports two sync backends covering Taskwarrior 2.6.2 and 3.x. TaskChampion is the modern one and is recommended for new setups. ### TaskChampion (recommended) @@ -120,14 +120,14 @@ The app syncs through TaskChampion for Taskwarrior 3.x workflows. You can use [W ### Legacy TaskServer -TaskServer sync is for Taskwarrior 2.x workflows. It lets you share tasks across clients and devices, and keeps an automatic backup of your data. +TaskServer sync is for Taskwarrior 2.6.2 workflows. It lets you share tasks across clients and devices, and keeps a server-side copy of your data. **Self-hosted TaskServer** - Official setup guide: [taskserver-setup](https://gothenburgbitfactory.github.io/taskserver-setup/) - Video tutorial: [Watch on YouTube](https://www.youtube.com/watch?v=6Ci_JyvVIaI&ab_channel=MetaphysicsComputing) - Cloud hosting: run it on Azure or any other cloud provider for access from anywhere. -- Docker: [ogarcia/docker-taskd](https://github.com/ogarcia/docker-taskd) +- Docker: [ogarcia/docker-taskd](https://github.com/ogarcia/docker-taskd) (archived upstream) ## Contributing