hamtask 0.1.0

A vim-style Taskwarrior TUI built with Textual.

hamtask

hamtask is a vim-style Taskwarrior TUI built with Python and Textual.

Goals

• List-first, keyboard-only interface.
• Use Taskwarrior's native filters and raw command arguments.
• Read report.next.filter, report.next.columns, report.next.labels, and report.next.sort from ~/.taskrc or ~/.config/task/taskrc.
• Mutate tasks by invoking the task command, never by editing Taskwarrior data files directly.

Requirements

• Python 3.11+
• Taskwarrior's task command must be installed and configured

Install from PyPI

After hamtask is published to PyPI, users can install it as a uv tool:

uv tool install hamtask

Then run:

hamtask

Update an installed PyPI version with:

uv tool upgrade hamtask

Run during development

uv run hamtask

Local installation

Install the current checkout as a uv tool:

uv tool install .

Then run:

hamtask

If your shell cannot find hamtask, run:

uv tool update-shell

Then restart your terminal or reload your shell config.

Update local installation

After changing the local source code, reinstall with:

uv tool install . --force

Uninstall

uv tool uninstall hamtask

Publish to PyPI

Before publishing, verify the project:

uv run ruff check .
uv run pytest
uv build

This creates distribution files in dist/.

For a first test release, publish to TestPyPI:

uv publish --publish-url https://test.pypi.org/legacy/ --token <test-pypi-token>

Install from TestPyPI with PyPI as the fallback index for dependencies:

uv tool install \
  --index-url https://test.pypi.org/simple/ \
  --extra-index-url https://pypi.org/simple \
  hamtask

Publish to PyPI:

uv publish --token <pypi-token>

For later releases:

1. Bump version in pyproject.toml.
2. Run checks and build again.
3. Publish with uv publish --token <pypi-token>.

Key bindings

• j / k: move down/up
• g: go to top
• G: go to bottom
• r: refresh
• q: quit
• enter: toggle bottom task details
• /: apply Taskwarrior filter
• :: command mode
• a: task add ...
• m: task <uuid> modify ...
• e: task <uuid> edit
• A: task <uuid> annotate ...
• d: task <uuid> done
• u: task undo
• x: delete with confirmation
• ?: show all shortcuts

Command mode

Supported commands:

:q
:quit
:r
:refresh
:f <filter>
:filter <filter>
:add <raw task args>
:mod <raw task args>
:modify <raw task args>
:done
:undo
:delete
:annotate <text>