Skip to content

HanzCEO/t

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

CLI TUI curses TODO List, kanban-style, global and local

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •