A beautiful and simple CLI task tracker written in Rust.
- 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
cargo install —git https://github.com/Miisan-png/rtask
- Clone the repository:
git clone https://github.com/Miisan-png/rtask.git
cd rtask- Build the project:
cargo build --release- Install the binary:
cargo install --path .When you first run rtask, you'll be prompted to configure the application:
rtaskRTask supports both full commands and short aliases similar to Git:
# 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 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# Mark a task as complete by ID
rtask complete 1
rtask done 1
rtask c 1# Update task progress by percentage (0-100)
rtask progress 1 50
rtask prog 1 75
rtask p 1 25# 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 a task by ID
rtask remove 2
rtask rm 2
rtask delete 2# Show detailed information about a specific task
rtask show 1
rtask s 1# Show tasks due today
rtask today
rtask td# Change RTask settings
rtask config
rtask cfgLaunch the interactive mode by running rtask without any commands:
rtaskThe interactive mode has been enhanced with new menu options:
- Update task progress
- Manage subtasks
By default, tasks are stored in your home directory:
- Windows:
C:\Users\<username>\.rtasks\tasks.json
You can change this location during configuration.
MIT License - see the LICENSE file for details.
- Inspired by CLI tools like Git and Todo.txt and warrorir
- Built with Rust and various awesome crates