Taskwarrior Time

English · Русский

Taskwarrior Time is an Omarchy bar widget that brings Taskwarrior and Timewarrior into the shell panel. Create, edit, filter, and time-track tasks without leaving the desktop.

What this is

Taskwarrior Time (plugin id taskwarrior-time) is a GUI companion for the classic CLI task stack — not a separate task database.

Component	Role
Taskwarrior (task)	Source of truth for tasks, projects, priorities, dates, dependencies, and status
Timewarrior (timew)	Time tracking: start/stop timers and today totals (optional but recommended)
Omarchy shell	Host panel: this plugin talks to task / timew through a small local helper

Anything you do here is stored in your normal Taskwarrior / Timewarrior data. You can still use the same tasks from the terminal (task, timew) — the panel is an add-on UI on top of those tools.

Features

• Task list with grouping (project, priority, due, status) and a collapsible advanced filter
• Create & edit in place: title, details, status (Waiting / In progress / Done), waiting-for, outcome, priority, project
• Schedule fields (scheduled / due), dependencies (depends / blocks), and Timewarrior timers with manual time adjust
• Progressive list meta: project · priority · due (Today / Tomorrow / Overdue) · blocked — colors follow the Omarchy theme
• Projects view: browse projects, rename, clear project from tasks
• Unsaved changes dialog when closing a dirty editor (Save / Keep editing / Discard)
• Uniform hotkeys: Ctrl+Enter commit, Esc cancel, Ctrl+Delete destroy
• i18n: English and Russian UI (system language, or pick one in About)
• About tab with version, developer info, GitHub link, language switch, and debug logging toggle

Task list

Grouping

Group the list by project, priority, due, or status from the toolbar.

Filter & search

Expand Filter to narrow by status, project, priority, due, timer, and dependencies, plus a free-text search over descriptions.

New task composer

The sticky composer at the bottom expands into the same field layout as the editor: details, status, waiting-for, priority, project, and optional schedule / deps / time under a spoiler.

Task editor

Click a task to edit it in place. Save when dirty (Ctrl+Enter), Cancel (Esc) to collapse, or Delete (Ctrl+Delete).

Projects

Switch to Projects to list projects, rename them, clear a project from all tasks, or add a new one.

Requirements

• Omarchy Linux (Quickshell bar / plugin system)
• Taskwarrior (task) — install the task package from your distro
• Timewarrior (timew) — optional but recommended for timers; install the timew package from your distro

The plugin does not install system packages itself. On Arch Linux the package names are task and timew.

Install (Linux / Omarchy)

Preferred — Omarchy clones and enables the plugin for you:

omarchy plugin add https://github.com/DataArchitectPro/taskwarrior-time.git --enable --yes

Then place the widget on the bar if it is not already there (the installer may ask for a section), or add it manually:

omarchy bar move taskwarrior-time --section right

Reload the shell if the icon does not appear:

omarchy restart shell

Developer checkout

For local development, place or clone this repository at ~/.config/omarchy/plugins/taskwarrior-time, then:

omarchy plugin enable taskwarrior-time --section right
omarchy restart shell

The plugin id is taskwarrior-time (folder name under ~/.config/omarchy/plugins/). The marketplace display name is Taskwarrior Time.

Update

If the plugin was installed with omarchy plugin add (git remote present):

omarchy plugin update taskwarrior-time --yes

Or manually:

git -C ~/.config/omarchy/plugins/taskwarrior-time pull --ff-only
omarchy restart shell

Saved files under ~/.config/omarchy/plugins/ are hot-reloaded by the shell; a full restart is only needed if something fails to apply.

Uninstall

omarchy plugin remove taskwarrior-time

This disables the widget and deletes the git checkout under ~/.config/omarchy/plugins/taskwarrior-time. Your Taskwarrior / Timewarrior data is not removed.

Usage

1. Left-click the Taskwarrior Time icon on the bar to open the panel.
2. Use Tasks / Projects in the header to switch views.
3. Expand Filter when you need status / project / priority / due / timer / deps or search.
4. Click a task to expand the editor; Save, Cancel, or Delete at the bottom of the card.
5. Focus the composer at the bottom to add a new task with the full form.
6. Open About in the header tabs for version info, GitHub, and debug logging.

Debug logging

When something misbehaves, turn on debug logging from the About tab.

• Toggle Debug log: ON / OFF on the About tab.

• While enabled, the bar icon stays highlighted and the tooltip shows that logging is active.

• Events are appended to:

  ~/.local/share/taskwarrior-time/debug.log

The log is local only (it is not uploaded). Include relevant excerpts when you open a GitHub issue — they help reproduce UI and helper (bin/taskwarrior-time) problems.

To turn logging off, open the About tab again and toggle it back to OFF (or delete/ignore the log file; the toggle controls whether new events are written).

Reporting issues

If you hit a bug, a crash, wrong Taskwarrior/Timewarrior behavior, or a missing feature:

1. Check existing issues.
2. Open a new issue with:
   • Omarchy / Taskwarrior Time version (see About)
   • Steps to reproduce
   • Expected vs actual behavior
   • Optional: a redacted snippet from ~/.local/share/taskwarrior-time/debug.log

Please do not paste secrets, tokens, or private task content.

License

MIT — free to use, copy, modify, merge, publish, distribute, sublicense, and sell. Keep the copyright notice.

Author

DataArchitectPro — GitHub repository