A simple, fast, local CLI tool for tracking tasks and records from unix terminal.
Installation:
cargo install tascli
# or use brew
brew tap Aperocky/tascli
brew install tascliTasks and records are stored in ~/.local/share/tascli/tascli.db (configurable) with rusqlite.
Create tasks with deadlines:
# Basic tasks
tascli task "Create readme" today
tascli task "Publish package" tomorrow
tascli task "Do taxes" 4/15
# With category
tascli task -c work "Read emails" weekCreate recurring tasks:
tascli task "write diary" daily
tascli task "mortgage payment" "monthly 17th"List tasks:
# List active tasks
$ tascli list taskoutput:
Task List:
----------------------------------------------------------------------------------------------
| Index | Category | Content | Deadline |
----------------------------------------------------------------------------------------------
| 1 | life (recurring) | write diary | Today |
----------------------------------------------------------------------------------------------
| 2 | tascli | Add pagination capability for tascli | Sunday |
| | | list actions | |
----------------------------------------------------------------------------------------------
| 3 | tascli | Add readme section on timestring | Sunday |
| | | format | |
----------------------------------------------------------------------------------------------
| 4 | life | Do state taxes | Sunday |
----------------------------------------------------------------------------------------------
| 5 | tascli | Sort list output by time instead of | Sunday |
| | | internal id | |
----------------------------------------------------------------------------------------------
| 6 | tascli | Fix length issue for unicode chars | Sunday |
----------------------------------------------------------------------------------------------
| 7 | life | Two month pictures - follow the lead | 4/23 |
| | | from the previous one month pictures | |
----------------------------------------------------------------------------------------------
Complete tasks:
# Mark index 1 as done
tascli done 1Completing a task or a recurring tasks will generate a corresponding record.
Search tasks:
tascli list task --search "rust"List all tasks in tascli category (including completed)
tascli list task -s all -c tascliExample output:
Task List:
----------------------------------------------------------------------------------------------
| Index | Category | Content | Deadline |
----------------------------------------------------------------------------------------------
| 1 | baby (Recurring) | Mix egg yolk milk for Rowan | Daily (fulfilled) |
----------------------------------------------------------------------------------------------
| 2 | tascli | Fix addition and modification commands| Today (completed) |
| | | output to have N/A for index | |
----------------------------------------------------------------------------------------------
| 3 | tascli | Insert guardrail against accidental | Today (completed) |
| | | valid syntax like 'task list' that is | |
| | | mistakenly made | |
----------------------------------------------------------------------------------------------
| 4 | tascli | Create a gif for readme | Today (completed) |
----------------------------------------------------------------------------------------------
| 5 | tascli | Add pagination capability for tascli | Sunday |
| | | list actions | |
----------------------------------------------------------------------------------------------
| 6 | tascli | Add readme section on timestring | Sunday |
| | | format | |
----------------------------------------------------------------------------------------------
Create records (for tracking events):
# With current time
tascli record -c feeding "100ML"
# With specific time
tascli record -c feeding -t 11:20AM "100ML"List records:
# -d 1 stand for only get last 1 day of record
tascli list record -d 1Search records:
tascli list record --search "secret"Example output:
Records List:
----------------------------------------------------------------------------------------------
| Index | Category | Content | Created At |
----------------------------------------------------------------------------------------------
| 1 | feeding | 110ML | Today 1:00AM |
----------------------------------------------------------------------------------------------
| 2 | feeding | breastfeeding | Today 4:10AM |
----------------------------------------------------------------------------------------------
| 3 | feeding | 100ML | Today 7:30AM |
----------------------------------------------------------------------------------------------
| 3 | life (Recurring) | write diary | Today 10:30AM |
----------------------------------------------------------------------------------------------
| 4 | feeding | 110ML | Today 11:20AM |
----------------------------------------------------------------------------------------------
This application accepts flexible time strings in various formats:
- Simple dates:
today,tomorrow,yesterday,friday,eom(end of month),eoy(end of year) - Date formats:
YYYY-MM-DD,MM/DD/YYYY,MM/DD(current year) - Time formats:
HH:MM,3:00PM,3PM - Combined:
2025-03-24 15:30,tomorrow 3PM
When only a date is provided, the time defaults to end of day (23:59:59). When only a time is provided, the date defaults to today.
Recurring Formats (schedules) are applicable to tasks:
- Recurring Formats:
daily,daily 9PM,weekly,weekly Friday 9AM,weekly mon-fri,monthly 1st - Recurring Formats (II):
every day,every 9PM,every monday,every 9th of the month,every 2/14
If storing the db file in location other than ~/.local/share/tascli/tascli.db is preferred, create a config file:
{
"data_dir": "/where/you/want/it"
}
at ~/.config/tascli/config.json to adjust the location of the stored file. Note, if you already have existing tasks, you may want to move/copy the db file there first.
tascli uses clap for argument parsing, use --help to get help on all levels of this cli:
aperocky@~$ tascli -h
Usage: tascli <COMMAND>
Commands:
task add task with end time
record add record
done Finish tasks
update Update tasks or records wording/deadlines
delete Delete Records or Tasks
list list tasks or records
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version
aperocky@~$ tascli task -h
add task with end time
Usage: tascli task [OPTIONS] <CONTENT> [TIMESTR]
Arguments:
<CONTENT> Description of the task
[TIMESTR] Time the task is due, default to EOD
Options:
-c, --category <CATEGORY> Category of the task
-h, --help Print help
