Skip to content
Back to search

tascli

SkillWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aperocky--tascli/badge.svg)](/listings/aperocky--tascli)

HTML

<a href="/listings/aperocky--tascli"><img src="/api/listings/aperocky--tascli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

  1. ---
  2. name: tascli
  3. description: >
  4. Track tasks, todos, deadlines, and records using tascli CLI.
  5. Use when the user wants to: add a task, create a todo, set a deadline,
  6. track progress, record my progress, log what happened, add this to roadmap,
  7. mark something done, check what's due, list my tasks, what's overdue,
  8. remind me, schedule a task, plan my week, what did I do, show my records,
  9. log an observation, track a habit, add to my backlog, what's on my plate.
  10. allowed-tools: Bash(tascli *)
  11. ---
  12. # tascli — Task and Record Tracking
  13. `tascli` is a local CLI tool for tracking tasks and records. Data is stored in SQLite at `~/.local/share/tascli/tascli.db`.
  14. - **Task**: something to be done, has a deadline and a status. Completing a task (`done`) automatically creates a record.
  15. - **Record**: a log entry of something that happened, has a timestamp. Records are append-only observations.
  16. - **Category**: optional grouping label for both tasks and records (`-c`).
  17. ## Tasks
  18. ### Add a task
  19. ```sh
  20. tascli task "description" # due end of today
  21. tascli task "description" friday # due this Friday
  22. tascli task "description" "2026/03/20 3PM" # due specific datetime
  23. tascli task "description" -c work # with category
  24. tascli task "description" "Daily 9AM" -c work # recurring task
  25. ```
  26. **Time strings**: `today`, `tomorrow`, `friday`, `eod`, `eom`, `eoy`, `2026/03/20`, `3PM`, `tomorrow 9AM`, `2026/03/20 14:00`
  27. **Recurring schedules**: `Daily 9AM`, `Weekly Monday 9AM`, `Weekly Monday-Friday 3PM`, `Monthly 1st 9AM`, `Yearly 7/4 12PM`
  28. ### List tasks
  29. ```sh
  30. tascli list task # open tasks (default)
  31. tascli list task today # due today
  32. tascli list task -c work # by category
  33. tascli list task -s all # all statuses
  34. tascli list task -s done # completed tasks
  35. tascli list task --search "text" # search content
  36. tascli list task --overdue # show overdue tasks
  37. ```
  38. **Statuses**: `ongoing`, `done`, `cancelled`, `duplicate`, `suspended`, `pending`, `open`, `closed`, `all`
  39. ### Complete a task
  40. ```sh
  41. tascli list task # get index first
  42. tascli done 1 # complete by index
  43. tascli done 1 -c "optional comment" # with comment
  44. ```
  45. ### Update a task
  46. ```sh
  47. tascli update 1 -t friday # change deadline
  48. tascli update 1 -c work # change category
  49. tascli update 1 -w "new description" # replace content
  50. tascli update 1 -a "appended note" # append to content
  51. tascli update 1 -s suspended # change status
  52. ```
  53. ### Delete
  54. ```sh
  55. tascli list task -s all --search "text" # find it first
  56. yes | tascli delete 1 # delete by index (yes skips confirmation)
  57. ```
  58. ## Records
  59. ### Add a record
  60. ```sh
  61. tascli record "what happened" # timestamped now
  62. tascli record "what happened" -c feeding # with category
  63. tascli record "what happened" -t "2PM" # at a specific time
  64. tascli record "what happened" -t "yesterday 3PM"
  65. ```
  66. ### List records
  67. ```sh
  68. tascli list record # recent records
  69. tascli list record -c feeding # by category
  70. tascli list record -d 7 # last 7 days
  71. tascli list record -s "yesterday" -e "today" # time range
  72. tascli list record --search "text" # search content
  73. ```
  74. ## Workflow
  75. 1. **Search first**: `tascli list task --search "keyword"` — check for duplicates before creating
  76. 2. **Create if new**: `tascli task "do something" friday -c work`
  77. 3. **Fresh list before mutating**: `tascli list task` — indexes are ephemeral and reset on each list, always re-list before `done`, `update`, or `delete`
  78. 4. **Complete**: `tascli done <index>` — this also creates a record automatically
  79. 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.

  1. # tascli
  2. [![Crates.io](https://img.shields.io/crates/v/tascli.svg)](https://crates.io/crates/tascli)
  3. [![tests](https://github.com/Aperocky/tascli/workflows/tests/badge.svg)](https://github.com/Aperocky/tascli/actions?query=workflow%3Atests)
  4. [![benchmark](https://github.com/Aperocky/tascli/workflows/benchmark/badge.svg)](https://github.com/Aperocky/tascli/actions?query=workflow%3Abenchmark)
  5. ![Downloads](https://img.shields.io/crates/d/tascli.svg)
  6. A *small (<2MB), simple, fast (<10ms), local* CLI tool for tracking tasks and records from unix terminal.
  7. Installation:
  8. ```bash
  9. cargo install tascli
  10. # or use brew
  11. brew tap Aperocky/tascli
  12. brew install tascli
  13. ```
  14. ![tascli demo](demo/tascli.gif)
  15. ## Basic Usage
  16. Tasks and records are stored in `~/.local/share/tascli/tascli.db` (configurable) with `sqlite`.
  17. ### Tasks
  18. Create tasks with deadlines:
  19. ```bash
  20. # Basic tasks
  21. tascli task "Create readme" today
  22. tascli task "Publish package" tomorrow
  23. tascli task "Do taxes" 4/15
  24. # With category
  25. tascli task -c work "Read emails" week
  26. ```
  27. Create recurring tasks:
  28. ```bash
  29. tascli task "write diary" daily
  30. tascli task "mortgage payment" "monthly 17th"
  31. ```
  32. List tasks:
  33. ```bash
  34. # List active tasks
  35. $ tascli list task
  36. ```
  37. output:
  38. ```
  39. Task List:
  40. ----------------------------------------------------------------------------------------------
  41. | Index | Category | Content | Deadline |
  42. ----------------------------------------------------------------------------------------------
  43. | 1 | life (recurring) | write diary | Today |
  44. ----------------------------------------------------------------------------------------------
  45. | 2 | tascli | Add pagination capability for tascli | Sunday |
  46. | | | list actions | |
  47. ----------------------------------------------------------------------------------------------
  48. | 3 | tascli | Add readme section on timestring | Sunday |
  49. | | | format | |
  50. ----------------------------------------------------------------------------------------------
  51. | 4 | life | Do state taxes | Sunday |
  52. ----------------------------------------------------------------------------------------------
  53. | 5 | tascli | Sort list output by time instead of | Sunday |
  54. | | | internal id | |
  55. ----------------------------------------------------------------------------------------------
  56. | 6 | tascli | Fix length issue for unicode chars | Sunday |
  57. ----------------------------------------------------------------------------------------------
  58. | 7 | life | Two month pictures - follow the lead | 4/23 |
  59. | | | from the previous one month pictures | |
  60. ----------------------------------------------------------------------------------------------
  61. ```
  62. Complete tasks:
  63. ```bash
  64. # Mark index 1 as done
  65. tascli done 1
  66. ```
  67. Completing a task or a recurring tasks will generate a corresponding record.
  68. You can complete all tasks due today interactively with
  69. ```bash
  70. tascli done today
  71. ```
  72. Search tasks:
  73. ```bash
  74. tascli list task --search "rust"
  75. ```
  76. List all tasks in `tascli` category (including completed)
  77. ```bash
  78. tascli list task -s all -c tascli
  79. ```
  80. Example output:
  81. ```
  82. Task List:
  83. ----------------------------------------------------------------------------------------------
  84. | Index | Category | Content | Deadline |
  85. ----------------------------------------------------------------------------------------------
  86. | 1 | baby (Recurring) | Mix egg yolk milk for Rowan | Daily (fulfilled) |
  87. ----------------------------------------------------------------------------------------------
  88. | 2 | tascli | Fix addition and modification commands| Today (completed) |
  89. | | | output to have N/A for index | |
  90. ----------------------------------------------------------------------------------------------
  91. | 3 | tascli | Insert guardrail against accidental | Today (completed) |
  92. | | | valid syntax like 'task list' that is | |
  93. | | | mistakenly made | |
  94. ----------------------------------------------------------------------------------------------
  95. | 4 | tascli | Create a gif for readme | Today (completed) |
  96. ----------------------------------------------------------------------------------------------
  97. | 5 | tascli | Add pagination capability for tascli | Sunday |
  98. | | | list actions | |
  99. ----------------------------------------------------------------------------------------------
  100. | 6 | tascli | Add readme section on timestring | Sunday |
  101. | | | format | |
  102. ----------------------------------------------------------------------------------------------
  103. ```
  104. ### Records
  105. Create records (for tracking events):
  106. ```bash
  107. # With current time
  108. tascli record -c feeding "100ML"
  109. # With specific time
  110. tascli record -c feeding -t 11:20AM "100ML"
  111. ```
  112. List records:
  113. ```bash
  114. # -d 1 stand for only get last 1 day of record
  115. tascli list record -d 1
  116. ```
  117. Search records:
  118. ```bash
  119. tascli list record --search "secret"
  120. ```
  121. Example output:
  122. ```
  123. Records List:
  124. ----------------------------------------------------------------------------------------------
  125. | Index | Category | Content | Created At |
  126. ----------------------------------------------------------------------------------------------
  127. | 1 | feeding | 110ML | Today 1:00AM |
  128. ----------------------------------------------------------------------------------------------
  129. | 2 | feeding | breastfeeding | Today 4:10AM |
  130. ----------------------------------------------------------------------------------------------
  131. | 3 | feeding | 100ML | Today 7:30AM |
  132. ----------------------------------------------------------------------------------------------
  133. | 3 | life (Recurring) | write diary | Today 10:30AM |
  134. ----------------------------------------------------------------------------------------------
  135. | 4 | feeding | 110ML | Today 11:20AM |
  136. ----------------------------------------------------------------------------------------------
  137. ```
  138. ### Housekeeping
  139. `ops` commands can be used to stat, migrate categories, batch close or delete tasks and record:
  140. ```
  141. $ tascli ops stat
  142. Statistics:
  143. ---------------------------------------------------------------------------------------------
  144. | Category | Task | Record | Recur Task | Recur Record| Total |
  145. ---------------------------------------------------------------------------------------------
  146. | life | 22 | 14 | 7 | 17 | 60 |
  147. | baby | 9 | 19 | 1 | 11 | 40 |
  148. | tascli | 28 | 5 | 0 | 0 | 33 |
  149. | personal | 5 | 3 | 2 | 11 | 21 |
  150. ...
  151. ```
  152. 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.
  153. ```
  154. $ tascli ops batch -c sport --category-to personal
  155. backing up database prior to batch operation
  156. Backed up to: /Users/aperocky/.local/share/tascli/tascli_bak.db
  157. Found 2 items matching filters:
  158. ---------------------------------------------------------------------------------------
  159. | Index | Category | Content | Time |
  160. ---------------------------------------------------------------------------------------
  161. | 1 | sport | Do a FTP test | 2025/03/30 ( |
  162. | | | | completed) |
  163. ---------------------------------------------------------------------------------------
  164. | 2 | sport | Nice run today 5K, finally sub | 2025/3/29 10:28PM |
  165. | | | 140 HR for sub 6 pace | |
  166. ---------------------------------------------------------------------------------------
  167. Operation to apply:
  168. • Change category to: personal
  169. Proceed? (y/n): y
  170. ✓ Successfully updated 2 items
  171. ```
  172. ### Time Format
  173. This application accepts flexible time strings in various formats:
  174. - **Simple dates**: `today`, `tomorrow`, `yesterday`, `friday`, `eom` (end of month), `eoy` (end of year)
  175. - **Date formats**: `YYYY-MM-DD`, `MM/DD/YYYY`, `MM/DD` (current year)
  176. - **Time formats**: `HH:MM`, `3:00PM`, `3PM`
  177. - **Combined**: `2025-03-24 15:30`, `tomorrow 3PM`
  178. 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.
  179. Recurring Formats (schedules) are applicable to tasks:
  180. - **Recurring Formats**: `daily`, `daily 9PM`, `weekly`, `weekly Friday 9AM`, `weekly mon-fri`, `monthly 1st`
  181. - **Recurring Formats (II)**: `every day`, `every 9PM`, `every monday`, `every 9th of the month`, `every 2/14`
  182. ### Configuration
  183. If storing the db file in location other than `~/.local/share/tascli/tascli.db` is preferred, create a config file:
  184. ```
  185. {
  186. "data_dir": "/where/you/want/it",
  187. "time_format": "standard"
  188. }
  189. ```
  190. 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.
  191. ### Help
  192. `tascli` uses `clap` for argument parsing, use `--help` to get help on all levels of this cli:
  193. ```
  194. aperocky@~$ tascli -h
  195. Usage: tascli <COMMAND>
  196. Commands:
  197. task add task with end time
  198. record add record
  199. done Finish tasks
  200. update Update tasks or records wording/deadlines
  201. delete Delete Records or Tasks
  202. list list tasks or records
  203. ops operations and statistics
  204. help Print this message or the help of the given subcommand(s)
  205. Options:
  206. -h, --help Print help
  207. -V, --version Print version
  208. aperocky@~$ tascli list -h
  209. list tasks or records
  210. Usage: tascli list <COMMAND>
  211. Commands:
  212. task list tasks
  213. record list records
  214. show show specific listed item content directly for ease to copy
  215. help Print this message or the help of the given subcommand(s)
  216. Options:
  217. -h, --help Print help

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.