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
Metadata
1 maintainer
Release files for todo-merger 2.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| todo_merger-2.1.4.tar.gz | 766.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| todo_merger-2.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.5 MB
Release files / todo_merger-2.1.4.tar.gz
| Download URL | todo_merger-2.1.4.tar.gz |
|---|---|
| Size | 766.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
68a82ded40cccfee76d5ea937fd3691b9fe0416ca436f947edc075d8a739385f
|
|
BLAKE2b-256 checksum How to use checksums |
6f9f175c04a666f6a2a9ab3a88c1f6e2ce9349afda826be1d4c5de89a6ffad9f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / todo_merger-2.1.4-py3-none-any.whl
| Download URL | todo_merger-2.1.4-py3-none-any.whl |
|---|---|
| Size | 772.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a7b185498a761758fb5caa9ec91b2bbfb4fa669738e937b33f034298325c33e6
|
|
BLAKE2b-256 checksum How to use checksums |
554ec50550f755be06abc453c00c65d907901e37066890598b13e209542e26aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency log
