# tascli
[](https://crates.io/crates/tascli)
[](https://github.com/Aperocky/tascli/actions?query=workflow%3Atests)
[](https://github.com/Aperocky/tascli/actions?query=workflow%3Abenchmark)
A *small (<2MB), simple, fast (<10ms), local* CLI tool for tracking tasks and records from unix terminal.
Installation:
```bash
cargo install tascli
# or use brew
brew tap Aperocky/tascli
brew install tascli
```
## Basic Usage
Tasks and records are stored in `~/.local/share/tascli/tascli.db` (configurable) with `sqlite`.
### Tasks
Create tasks with deadlines:
```bash
# 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" week
```
Create recurring tasks:
```bash
tascli task "write diary" daily
tascli task "mortgage payment" "monthly 17th"
```
List tasks:
```bash
# List active tasks
$ tascli list task
```
output:
```
Task List:
----------------------------------------------------------------------------------------------
| 1 | life (recurring) | write diary | Today |
----------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------
| 5 | tascli | Sort list output by time instead of | Sunday |
| | | internal id | |
----------------------------------------------------------------------------------------------
| 7 | life | Two month pictures - follow the lead | 4/23 |
| | | from the previous one month pictures | |
----------------------------------------------------------------------------------------------
```
Complete tasks:
```bash
# Mark index 1 as done
tascli done 1
```
Completing a task or a recurring tasks will generate a corresponding record.
Search tasks:
```bash
tascli list task --search "rust"
```
List all tasks in `tascli` category (including completed)
```bash
tascli list task -s all -c tascli
```
Example output:
```
Task List:
----------------------------------------------------------------------------------------------
| 1 | baby (Recurring) | Mix egg yolk milk for Rowan | Daily (fulfilled) |
----------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------
| | | mistakenly made | |
----------------------------------------------------------------------------------------------
| 5 | tascli | Add pagination capability for tascli | Sunday |
| | | list actions | |
----------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------
```
### Records
Create records (for tracking events):
```bash
# With current time
tascli record -c feeding "100ML"
# With specific time
tascli record -c feeding -t 11:20AM "100ML"
```
List records:
```bash
# -d 1 stand for only get last 1 day of record
tascli list record -d 1
```
Search records:
```bash
tascli list record --search "secret"
```
Example output:
```
Records List:
----------------------------------------------------------------------------------------------
| 1 | feeding | 110ML | Today 1:00AM |
----------------------------------------------------------------------------------------------
| 3 | feeding | 100ML | Today 7:30AM |
----------------------------------------------------------------------------------------------
| 4 | feeding | 110ML | Today 11:20AM |
----------------------------------------------------------------------------------------------
```
### Housekeeping
`ops` commands can be used to stat, migrate categories, batch close or delete tasks and record:
```
$ tascli ops stat
Statistics:
---------------------------------------------------------------------------------------------
| 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:
---------------------------------------------------------------------------------------
| 1 | sport | Do a FTP test | 2025/03/30 ( |
| | | | completed) |
---------------------------------------------------------------------------------------
---------------------------------------------------------------------------------------
Operation to apply:
• Change category to: personal
Proceed? (y/n): y
✓ Successfully updated 2 items
```
### Time Format
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`
### Configuration
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.
### Help
`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