ToDo Merger
Get a unified overview of all issues and tasks assigned to you across multiple platforms. A local web dashboard that aggregates GitHub, GitLab, Gitea, and Microsoft Planner into a single view, with personal prioritisation and a private task list. Additionally, a CLI for quick access to your tasks and labels.
Features
- Multi-platform aggregation — pulls assigned issues, merge/pull requests, and tasks from GitHub, one or more GitLab instances, Gitea instances, and local Microsoft Planner exports, all into a single view
- Graceful degradation — if an instance is unreachable (e.g. a company GitLab behind a VPN), the app keeps running and shows cached data for that instance with a warning banner; other services are unaffected. Connectivity is retried automatically on the next cache refresh
- Personal prioritisation — pin, promote, or deprioritise any issue without touching the upstream tracker; rankings are stored locally
- Todo list — mark individual issues as personal todos and filter the view to show only those
- New issue highlighting — issues you haven't seen before are highlighted until you dismiss them
- Private task creation — create new issues directly in a configured private repository (GitHub, GitLab, or Gitea) from within the dashboard
- Configurable display — toggle which metadata columns are shown (labels, milestones, epics, assignees, due dates, refs, …)
- Daemon mode — run as a background process with
todo-merger web -d/todo-merger web stop - CLI — quickly list all open tasks as JSON, a compact table, or verbose human-readable output; create new issues and list available labels from the private tasks repo
- Fast cache — configurable cache timeout (default 10 minutes) avoids hammering the APIs on every page load; manual refresh available at any time
Installation
pipx (recommended)
pipx installs the app in an isolated environment and keeps it off your system Python.
pip3 install pipx # install pipx if not already present
pipx install todo-merger # install todo-merger
todo-merger will be available in ~/.local/bin (add to $PATH if needed).
To run without installing permanently:
pipx run todo-merger
To upgrade:
pipx upgrade todo-merger
Other methods
pip install todo-merger # plain pip
uv tool install todo-merger # uv
Usage
Please see todo-merger --help for the latest usage instructions.
todo-merger [global options] <command> [command options]
Global options:
| Flag | Description |
|---|---|
-c, --config-file |
Path to the config file (default: ~/.config/todo-merger/config.toml) |
-v |
INFO logging |
-vv |
DEBUG logging |
-vvv |
DEBUG logging including verbose HTTP client logs |
--version |
Show version and exit |
Commands:
| Command | Description |
|---|---|
web |
Start the web interface (open http://localhost:8636) |
web -d |
Start in daemon (background) mode |
web stop |
Stop a running background instance |
web --port PORT |
Use a custom port |
list |
List all open tasks as JSON |
list --table |
Compact table view (rank, title, clickable link) |
list --plain |
Verbose human-readable output |
list --cache |
Use cached data without fetching from APIs |
labels |
List available labels from the private tasks repo |
create TITLE |
Create a new issue in the private tasks repo |
create TITLE --rank pin |
Create and immediately rank the issue |
create TITLE --label bug |
Create with a label (repeatable) |
Configuration
On first start, todo-merger creates an empty config file at ~/.config/todo-merger/config.toml. Edit it to add your service credentials.
See DEFAULT_APP_CONFIG in _config.py for all available options and their defaults.
Multiple instances of the same platform are supported — just add more [services.*] sections with unique names.
Unavailable instances
If a service is currently unavailable (e.g. because company VPN is disconnected), todo-merger handles it gracefully:
- App starts without connection — the unreachable instance is skipped and recorded as degraded; a warning banner is shown in the dashboard. Cached data from the last successful fetch is displayed.
- Connection reestablished later — the next cache refresh (or manual reload) automatically retries the login and fetch for the degraded instance. If it succeeds, the warning disappears.
- Connection drops mid-session — the failing instance falls back to its last cached data; all other services continue normally.
No configuration is needed for this behaviour — it is automatic.
License
The main license of this project is the GNU General Public License 3.0, no later version (GPL-3.0-only), Copyright Max Mehl.
Third-party components included under their respective licenses: Pico CSS (MIT), snippets from DB Systel (Apache-2.0).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file todo_merger-2.1.3.tar.gz.
File metadata
- Download URL: todo_merger-2.1.3.tar.gz
- Upload date:
- Size: 766.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
49397b3471047e5b13e8e9f34745b459a92863dea4cb9459817d0a1952665b22
|
|
| MD5 |
07df2e3774eb5bb087107a06f2c59945
|
|
| BLAKE2b-256 |
74c05b02d1178ed6f479cf123dbb6843ccc6d39adcb3bf17538b9a534892b5be
|
Provenance
The following attestation bundles were made for todo_merger-2.1.3.tar.gz:
Publisher:
release.yaml on mxmehl/todo-merger
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
todo_merger-2.1.3.tar.gz -
Subject digest:
49397b3471047e5b13e8e9f34745b459a92863dea4cb9459817d0a1952665b22 - Sigstore transparency entry: 2437287155
- Sigstore integration time:
-
Permalink:
mxmehl/todo-merger@ac646bc60ae7c1d1c6575a21f00a8d3a8b4ae1cd -
Branch / Tag:
refs/tags/v2.1.3 - Owner: https://github.com/mxmehl
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@ac646bc60ae7c1d1c6575a21f00a8d3a8b4ae1cd -
Trigger Event:
release
-
Statement type:
File details
Details for the file todo_merger-2.1.3-py3-none-any.whl.
File metadata
- Download URL: todo_merger-2.1.3-py3-none-any.whl
- Upload date:
- Size: 772.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
19ca27bae8dc7501a3e8f2b352a04ced04235c402295d6f44f604b3829bfca83
|
|
| MD5 |
2e56a9bd4b563b42ed3230b8ad3da603
|
|
| BLAKE2b-256 |
a3269ea6f8e46bece744b5d9385f8d2eb4f1d624e119b0f6713b821a5adea051
|
Provenance
The following attestation bundles were made for todo_merger-2.1.3-py3-none-any.whl:
Publisher:
release.yaml on mxmehl/todo-merger
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
todo_merger-2.1.3-py3-none-any.whl -
Subject digest:
19ca27bae8dc7501a3e8f2b352a04ced04235c402295d6f44f604b3829bfca83 - Sigstore transparency entry: 2437287299
- Sigstore integration time:
-
Permalink:
mxmehl/todo-merger@ac646bc60ae7c1d1c6575a21f00a8d3a8b4ae1cd -
Branch / Tag:
refs/tags/v2.1.3 - Owner: https://github.com/mxmehl
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@ac646bc60ae7c1d1c6575a21f00a8d3a8b4ae1cd -
Trigger Event:
release
-
Statement type:
