RTask - CLI Task Tracker

A beautiful and simple CLI task tracker written in Rust.

Screenshots

Features

• Simple and intuitive CLI interface
• Add, list, complete, and remove tasks
• Track task progress with percentage indicators
• Add subtasks and track their completion
• Tag tasks for organization
• Set due dates for tasks
• Interactive mode for ease of use
• Beautiful terminal UI with colors
• Configurable task storage location

Setting it up

Using Cargo

cargo install —git https://github.com/Miisan-png/rtask

From Source

1. Clone the repository:

git clone https://github.com/Miisan-png/rtask.git
cd rtask

2. Build the project:

cargo build --release

3. Install the binary:

cargo install --path .

Usage

First Run

When you first run rtask, you'll be prompted to configure the application:

rtask

Commands

RTask supports both full commands and short aliases similar to Git:

Add a Task

# Add a new task
rtask add "start learning rust?" --priority high --due 2025-04-15 --tags "work,urgent"

# Short form 
rtask a "tell my bum assignment teammate to contribute" -p medium -d 2025-03-20 -t "personal,uni"

List Tasks

# List all pending tasks
rtask list
rtask ls
rtask log

# List all tasks including completed ones
rtask list --all
rtask ls -a

# List only completed tasks
rtask list --completed
rtask ls -c

# Filter tasks by tag
rtask list --filter work
rtask ls -f work

Complete Tasks

# Mark a task as complete by ID
rtask complete 1
rtask done 1
rtask c 1

Update Task Progress

# Update task progress by percentage (0-100)
rtask progress 1 50
rtask prog 1 75
rtask p 1 25

Manage Subtasks

# Add a subtask to a task
rtask subtask add --task-id 1 "Research documentation"
rtask sub a -t 1 "Write unit tests"

# Toggle subtask completion
rtask subtask toggle --task-id 1 --subtask-index 1
rtask sub t -t 1 -s 1
rtask sub check -t 1 -s 2

# Remove a subtask
rtask subtask remove --task-id 1 --subtask-index 3
rtask sub rm -t 1 -s 3

Remove Tasks

# Remove a task by ID
rtask remove 2
rtask rm 2
rtask delete 2

View Task Details

# Show detailed information about a specific task
rtask show 1
rtask s 1

Show Today's Tasks

# Show tasks due today
rtask today
rtask td

Configuration

# Change RTask settings
rtask config
rtask cfg

Interactive Mode

Launch the interactive mode by running rtask without any commands:

rtask

The interactive mode has been enhanced with new menu options:

• Update task progress
• Manage subtasks

Task Storage

By default, tasks are stored in your home directory:

• Windows: C:\Users\<username>\.rtasks\tasks.json

You can change this location during configuration.

License

MIT License - see the LICENSE file for details.

Other Stuff

• Inspired by CLI tools like Git and Todo.txt and warrorir
• Built with Rust and various awesome crates