Tasks Tracker TUI

A minimalist task and study time manager built to run directly in the terminal. Developed in Ruby using Clean Architecture principles, Task Tracker focuses on reducing friction when it's time to study, offering a fast, distraction-free interface.

Why Ruby for a TUI (Terminal User Interfaces)?

Ruby is incredibly approachable and easy to modify, making it perfect for exploring Clean Architecture, and for a lightweight TUI tool like this, the performance difference compared to lower-level languages is completely negligible.

Prerequisites

• Ruby (version 3.2+ recommended)
• Bundler (gem install bundler)

Installation

1. Clone the repository:

   git clone [https://github.com/kalebhenrique/task-tracker-tui.git](https://github.com/kalebhenrique/task-tracker-tui.git)
   cd task-tracker-tui

2. Install dependencies:

   bundle install

3. Run the app to test:

   ruby bin/start

Keybindings

Navigation is 100% keyboard-driven:

Key	Action
↑ / ↓	Navigate between tasks
a	Add a new task
r	Rename the selected task
d	Delete the selected task
Space	Toggle completion status (Check/Uncheck)
t	Timer (Start/Pause tracking for selected task)
q	Quit and save data

---

Arch Linux & Omarchy Integration

To make Task Tracker a seamless part of your daily workflow in an Omarchy / Hyprland environment, you need to expose it as a global terminal command before adding it to your App Launcher.

Step 1: Create the Global Terminal Command (Prerequisite)

To avoid version conflicts with other Ruby projects or system gems, create a wrapper script that forces the app to run in its own isolated environment.

1. Create the executable file:

   nano ~/.local/bin/tasktui

2. Paste the following wrapper script:

   #!/bin/bash
   # Wrapper to run Task Tracker from anywhere
   ORIGINAL_DIR=$(pwd)
   cd "$HOME/task-tracker-tui" || exit
   bundle exec ruby bin/start
   cd "$ORIGINAL_DIR" || exit

3. Make it executable:

   chmod +x ~/.local/bin/tasktui

   (Ensure ~/.local/bin is in your $PATH within ~/.zshrc or ~/.bashrc).

Step 2: Add to Omarchy App Launcher

Now that the tasktui command is recognized by your terminal, you can easily add it to the Omarchy ecosystem using the native TUI installer.

1. Press SUPER + Alt + Space to open the Omarchy TUI installer.
2. Follow the on-screen prompts to create a new entry.
3. When asked for the command to execute, type: tasktui
4. Name your shortcut: Task Tracker TUI

You can now launch your study tracker instantly from your dashboard!