tascli
Track tasks, todos, deadlines, and records using tascli CLI. Use when the user wants to: add a task, create a todo, set a deadline, track progress, record my progress, log what happened, add this to roadmap, mark something done, check what's due, list my tasks, what's overdue, remind me, schedule a task, plan my week, what did I do, show my records, log an observation, track a habit, add to my backlog, what's on my plate.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/aperocky--tascli)HTML
<a href="/listings/aperocky--tascli"><img src="/api/listings/aperocky--tascli/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 96 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- ---
- name: tascli
- description: >
- Track tasks, todos, deadlines, and records using tascli CLI.
- Use when the user wants to: add a task, create a todo, set a deadline,
- track progress, record my progress, log what happened, add this to roadmap,
- mark something done, check what's due, list my tasks, what's overdue,
- remind me, schedule a task, plan my week, what did I do, show my records,
- log an observation, track a habit, add to my backlog, what's on my plate.
- allowed-tools: Bash(tascli *)
- ---
- # tascli — Task and Record Tracking
- `tascli` is a local CLI tool for tracking tasks and records. Data is stored in SQLite at `~/.local/share/tascli/tascli.db`.
- - **Task**: something to be done, has a deadline and a status. Completing a task (`done`) automatically creates a record.
- - **Record**: a log entry of something that happened, has a timestamp. Records are append-only observations.
- - **Category**: optional grouping label for both tasks and records (`-c`).
- ## Tasks
- ### Add a task
- ```sh
- tascli task "description" # due end of today
- tascli task "description" friday # due this Friday
- tascli task "description" "2026/03/20 3PM" # due specific datetime
- tascli task "description" -c work # with category
- tascli task "description" "Daily 9AM" -c work # recurring task
- ```
- **Time strings**: `today`, `tomorrow`, `friday`, `eod`, `eom`, `eoy`, `2026/03/20`, `3PM`, `tomorrow 9AM`, `2026/03/20 14:00`
- **Recurring schedules**: `Daily 9AM`, `Weekly Monday 9AM`, `Weekly Monday-Friday 3PM`, `Monthly 1st 9AM`, `Yearly 7/4 12PM`
- ### List tasks
- ```sh
- tascli list task # open tasks (default)
- tascli list task today # due today
- tascli list task -c work # by category
- tascli list task -s all # all statuses
- tascli list task -s done # completed tasks
- tascli list task --search "text" # search content
- tascli list task --overdue # show overdue tasks
- ```
- **Statuses**: `ongoing`, `done`, `cancelled`, `duplicate`, `suspended`, `pending`, `open`, `closed`, `all`
- ### Complete a task
- ```sh
- tascli list task # get index first
- tascli done 1 # complete by index
- tascli done 1 -c "optional comment" # with comment
- ```
- ### Update a task
- ```sh
- tascli update 1 -t friday # change deadline
- tascli update 1 -c work # change category
- tascli update 1 -w "new description" # replace content
- tascli update 1 -a "appended note" # append to content
- tascli update 1 -s suspended # change status
- ```
- ### Delete
- ```sh
- tascli list task -s all --search "text" # find it first
- yes | tascli delete 1 # delete by index (yes skips confirmation)
- ```
- ## Records
- ### Add a record
- ```sh
- tascli record "what happened" # timestamped now
- tascli record "what happened" -c feeding # with category
- tascli record "what happened" -t "2PM" # at a specific time
- tascli record "what happened" -t "yesterday 3PM"
- ```
- ### List records
- ```sh
- tascli list record # recent records
- tascli list record -c feeding # by category
- tascli list record -d 7 # last 7 days
- tascli list record -s "yesterday" -e "today" # time range
- tascli list record --search "text" # search content
- ```
- ## Workflow
- 1. **Search first**: `tascli list task --search "keyword"` — check for duplicates before creating
- 2. **Create if new**: `tascli task "do something" friday -c work`
- 3. **Fresh list before mutating**: `tascli list task` — indexes are ephemeral and reset on each list, always re-list before `done`, `update`, or `delete`
- 4. **Complete**: `tascli done <index>` — this also creates a record automatically
- 5. **Log directly**: `tascli record "observed something" -c work` — for things without a prior task; search with `tascli list record --search "keyword"` first to avoid duplicate records
README.md · README · 269 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # 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:
- ----------------------------------------------------------------------------------------------
- | 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:
- ```bash
- # 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
- ```bash
- tascli done today
- ```
- 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:
- ----------------------------------------------------------------------------------------------
- | 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):
- ```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:
- ----------------------------------------------------------------------------------------------
- | 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.