tascli

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

Basic Usage

Tasks and records are stored in ~/.local/share/tascli/tascli.db (configurable) with sqlite.

Tasks

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" week

Create recurring tasks:

tascli task "write diary" daily
tascli task "mortgage payment" "monthly 17th"

List tasks:

# List active tasks
$ tascli list task

output:

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 1

Completing a task or a recurring tasks will generate a corresponding record.

You can complete all tasks due today interactively with

tascli done today

Search tasks:

tascli list task --search "rust"

List all tasks in tascli category (including completed)

tascli list task -s all -c tascli

Example 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                                |                     |
----------------------------------------------------------------------------------------------

Records

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 1

Search 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       |
----------------------------------------------------------------------------------------------

Housekeeping

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

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",
    "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.

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