A small (<2MB), simple, fast (<10ms), local CLI tool for tracking tasks and records from unix terminal.
Installation:
cargo install tascli
# or use brew
brew tap Aperocky/tascli
brew install tascli
Tasks and records are stored in ~/.local/share/tascli/tascli.db (configurable) with sqlite.
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.
You can complete all tasks due today interactively with
tascli done todaySearch 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 |
----------------------------------------------------------------------------------------------
ops commands can be used to stat, migrate categories, batch close or delete tasks and record:
$ tascli ops stat
Statistics:
---------------------------------------------------------------------------------------------
| Category | Task | Record | Recur Task | Recur Record| Total |
---------------------------------------------------------------------------------------------
| life | 22 | 14 | 7 | 17 | 60 |
| baby | 9 | 19 | 1 | 11 | 40 |
| tascli | 28 | 5 | 0 | 0 | 33 |
| personal | 5 | 3 | 2 | 11 | 21 |
...
Example merge of category sport into personal, the ops batch command support --interactive flag so you can be selective in your changes. Each time more than one item is changed, a backup automatically happens.
$ tascli ops batch -c sport --category-to personal
backing up database prior to batch operation
Backed up to: /Users/aperocky/.local/share/tascli/tascli_bak.db
Found 2 items matching filters:
---------------------------------------------------------------------------------------
| Index | Category | Content | Time |
---------------------------------------------------------------------------------------
| 1 | sport | Do a FTP test | 2025/03/30 ( |
| | | | completed) |
---------------------------------------------------------------------------------------
| 2 | sport | Nice run today 5K, finally sub | 2025/3/29 10:28PM |
| | | 140 HR for sub 6 pace | |
---------------------------------------------------------------------------------------
Operation to apply:
• Change category to: personal
Proceed? (y/n): y
✓ Successfully updated 2 items
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",
"time_format": "standard"
}
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
ops operations and statistics
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version
aperocky@~$ tascli list -h
list tasks or records
Usage: tascli list <COMMAND>
Commands:
task list tasks
record list records
show show specific listed item content directly for ease to copy
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help