Skip to main content

A TUI kanban TODO list with priority classification

Project description

tterminal

A TUI kanban TODO list application with priority classification using the Eisenhower Matrix.

Features

  • 📝 Kanban Board: Organize tasks in Todo, Doing, and Done columns
  • Priority Classification: Use the Eisenhower Matrix to prioritize tasks
    • Urgent & Important (Do First)
    • Important, Not Urgent (Schedule)
    • Urgent, Not Important (Delegate)
    • Not Urgent, Not Important (Eliminate)
  • 🔧 Task Management: Create, edit, and delete tasks
  • 📊 Sorting: Toggle between priority and date sorting
  • 💾 Persistence: Tasks are automatically saved locally
  • ⌨️ Keyboard Navigation: Full keyboard control

Installation

Install from PyPI (once published):

pip install tterminal

Or install from source:

git clone https://github.com/HanzCEO/t.git
cd t
pip install -e .

Usage

Launch the application:

tterminal

Key Bindings

  • n: Create a new task
  • q: Quit the application
  • s: Toggle sorting between priority and date
  • esc: Exit current modal/dialog or focus main board
  • Click on task: Edit existing task

Creating Tasks

  1. Press n to open the new task dialog
  2. Enter a task title (required)
  3. Optionally add a description
  4. Select priority using the Eisenhower Matrix:
    • Urgent & Important: Critical tasks requiring immediate attention
    • Important, Not Urgent: Important tasks to schedule for later
    • Urgent, Not Important: Tasks that can be delegated
    • Not Urgent, Not Important: Tasks that can be eliminated
  5. Click "Create" or press Enter to save

Editing Tasks

  1. Click on any task to open the edit dialog
  2. Modify title, description, priority, or status
  3. Change status to move tasks between columns (Todo ↔ Doing ↔ Done)
  4. Click "Save" to update or "Delete" to remove the task

Sorting

Press s to toggle between:

  • Priority sorting: Orders tasks by Eisenhower Matrix priority
  • Date sorting: Orders tasks by creation date (newest first)

Data Storage

Tasks are automatically saved to ~/.tterminal/tasks.json and persist between sessions.

Author

Haxors - hanzhaxors@gmail.com

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tterminal-0.1.0.tar.gz (9.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tterminal-0.1.0-py3-none-any.whl (9.5 kB view details)

Uploaded Python 3

File details

Details for the file tterminal-0.1.0.tar.gz.

File metadata

  • Download URL: tterminal-0.1.0.tar.gz
  • Upload date:
  • Size: 9.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for tterminal-0.1.0.tar.gz
Algorithm Hash digest
SHA256 8f8cf9310b8ae976de956a1dae9df47cc170cc804850d1fe2de8d1203e09d679
MD5 1398cc78f62641cbc14120a8f91f3760
BLAKE2b-256 541bf70bc51e9f5db2546484d249c69c43837f9488432ad3d48b31d0fe5081a1

See more details on using hashes here.

File details

Details for the file tterminal-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: tterminal-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 9.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for tterminal-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 531d5735e3d4daf73bb6069e9e50354ba3100741c1e49da8f23f426a5290b40c
MD5 267f003f10b7e028d8b280708569ccc8
BLAKE2b-256 0666442b78d01e5ed4fa0988df7c8f9b21f85c8e0838a677588b9a925c24df6c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page