gtdhelper
Stop tab-hopping. See everything that needs your attention in one place.
gtdhelper is a lightweight desktop app that pulls actionable items from the tools you already use (GitHub, Trello, and more) and surfaces them in a compact overlay panel on your screen. One click opens any item in your browser. No context switching, no forgotten pull requests.
How it works
Section titled “How it works”gtdhelper sits in your system tray and periodically polls your configured sources every 5 minutes. When items need your attention, they appear in a borderless overlay panel anchored to the edge of your screen.
Each item shows its title, short reference, project, and age. Click any row to jump straight to it in your browser.
Manage your attention
Section titled “Manage your attention”Not everything needs your attention right now. Each task row has action buttons that appear on hover:
| Button | Action | Behavior |
|---|---|---|
| check | Done | Marks the item as completed and removes it from your list. The item won't reappear even if the source script still emits it. |
| snooze | Snooze | Hides the item until a chosen time. It reappears automatically when the snooze expires. Preserved across source refreshes. |
| archive | Archive | Dismisses the item from your list. It won't reappear unless the source stops emitting it and later re-emits it. |
You can also:
- Pin a task to keep it at the top of your list, above all unpinned items, regardless of sort order.
- Create local tasks directly in gtdhelper for things not from any external source. Local tasks behave like any other item and can be snoozed, archived, or pinned.
Built-in sources
Section titled “Built-in sources”gtdhelper ships with three bundled source scripts:
| Source | What it shows |
|---|---|
| GitHub | Open pull requests and issues assigned to you or requesting your review |
| Trello | Cards assigned to you on selected boards |
| RSS/Atom | Items from RSS and Atom feeds, with keyword filtering |
Each source activates when you create its config file in ~/.gtdhelper/. No source runs until you opt in.
Extensible by design
Section titled “Extensible by design”gtdhelper discovers and runs any executable script in ~/.gtdhelper/sources/. Write a script in any language that outputs JSON Lines to stdout, and your custom items appear alongside built-in sources. See Write a custom source script for a step-by-step guide.
Get started
Section titled “Get started”- Download the latest release (coming soon)
- Configure a source:
Documentation
Section titled “Documentation”This documentation follows the Diataxis framework:
| Section | Purpose |
|---|---|
| How-To Guides | Step-by-step instructions for specific tasks |
| Reference | Technical specifications and API contracts |