# RTW Commands * [RTW Commands](#rtw-commands) * [Start New Activity](#start-new-activity) * [Start tracking an activity now](#start-tracking-an-activity-now) * [Start tracking an activity 4 minutes ago](#start-tracking-an-activity-4-minutes-ago) * [Start tracking an activity at a specific time](#start-tracking-an-activity-at-a-specific-time) * [Stop Current Activity](#stop-current-activity) * [Stop current activity now](#stop-current-activity-now) * [Stop current activity 4 minutes ago](#stop-current-activity-4-minutes-ago) * [Stop current activity at a specific time](#stop-current-activity-at-a-specific-time) * [Cancel current activity](#cancel-current-activity) * [Display Summary](#display-summary) * [Display finished activities summary for today](#display-finished-activities-summary-for-today) * [Display finished activities summary for yesterday](#display-finished-activities-summary-for-yesterday) * [Display finished activities summary for last week](#display-finished-activities-summary-for-last-week) * [Display finished activities summary for range](#display-finished-activities-summary-for-range) * [Display finished activities id](#display-finished-activities-id) * [Display a report (sum same activities)](#display-a-report-sum-same-activities) * [Display a timeline](#display-a-timeline) * [For the day](#for-the-day) * [For the week](#for-the-week) * [For a time range](#for-a-time-range) * [Export Finished Activities to iCalendar](#export-finished-activities-to-icalendar) * [For today](#for-today) * [For last week](#for-last-week) * [For a given date range](#for-a-given-date-range) * [Continue Activity](#continue-activity) * [Continue last finished activity](#continue-last-finished-activity) * [Continue finished activity with id](#continue-finished-activity-with-id) * [Delete Activity](#delete-activity) * [Delete Activity with id](#delete-activity-with-id) * [Track a finished activity](#track-a-finished-activity) * [Track a finished activity with dates](#track-a-finished-activity-with-dates) * [Track a finished activity the same day](#track-a-finished-activity-the-same-day) * [Track an activity and provide a long description](#track-an-activity-and-provide-a-long-description) * [Display current status (for usage in scripts/status bars/prompts...)](#display-current-status-for-usage-in-scriptsstatus-barsprompts) * [For multitasking people](#for-multitasking-people) * [Start (overlapping) activities](#start-overlapping-activities) * [Stop ongoing activity](#stop-ongoing-activity) Created by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc) ## Start New Activity ### Start tracking an activity now Example: ``` rtw start write doc ``` Example output: ``` Tracking write doc Started 2019-12-25T19:43:00 ``` ### Start tracking an activity 4 minutes ago Example: ``` rtw start 4 min ago write doc ``` Example output: ``` Tracking write doc Started 2019-12-25T19:39:00 ``` ### Start tracking an activity at a specific time Example: ``` rtw start 2019-12-24T19:43:00 write doc ``` Example output: ``` Tracking write doc Started 2019-12-24T19:43:00 ``` ## Stop Current Activity ### Stop current activity now Example: ``` rtw stop ``` Example output: ``` Recorded write doc Started 2019-12-25T19:43:00 Ended 2019-12-25T19:50:00 Total 00:07:00 ``` ### Stop current activity 4 minutes ago Example: ``` rtw stop 4m ago ``` Example output: ``` Recorded write doc Started 2019-12-25T19:43:00 Ended 2019-12-25T19:46:00 Total 00:03:00 ``` ### Stop current activity at a specific time Example: ``` rtw stop 2019-12-25T19:45:00 ``` Example output: ``` Recorded write doc Started 2019-12-25T19:43:00 Ended 2019-12-25T19:45:00 Total 00:02:00 ``` ## Cancel current activity Example: ``` rtw cancel ``` Example output: ``` Cancelled write doc Started 2019-12-24T19:43:00 Total 00:20:05 ``` ## Display Summary ### Display finished activities summary for today Example: ``` rtw summary ``` Example output: ``` write doc 2019-12-25T19:43:00 2019-12-25T19:45:00 00:03:000 ``` ### Display finished activities summary for yesterday Example: ``` rtw summary --yesterday ``` Example output: ``` write doc 2019-12-24T19:43:00 2019-12-24T19:45:00 00:03:000 ``` ### Display finished activities summary for last week Example: ``` rtw summary --lastweek ``` Example output: ``` write doc 2019-12-17T19:43:00 2019-12-17T19:45:00 00:03:000 ``` ### Display finished activities summary for range Example: ``` rtw summary 19:00 - 20:00 ``` Example output: ``` write doc 2019-12-17T19:43:00 2019-12-17T19:45:00 00:03:000 ``` ### Display finished activities id Example: ``` rtw summary --id ``` Example output: ``` 2 foo 2019-12-25T17:43:00 2019-12-25T17:44:00 00:01:00 1 another foo 2019-12-25T18:43:00 2019-12-25T18:44:00 00:01:00 0 bar 2019-12-25T19:43:00 2019-12-25T19:44:00 00:01:00 ``` > id 0 = last finished activity ### Display a report (sum same activities) Example: ``` rtw track 8 - 9 foo rtw track 9 - 10 foo rtw track 10 - 11 bar rtw summary --report ``` Example output: ``` foo 02:00:00 (2 segments) bar 01:00:00 (1 segments) ``` ## Display a timeline ### For the day ```bash rtw day ``` Example output (YMMV): ![timeline](img/day.png) ### For the week ```bash rtw week ``` ### For a time range ```bash rtw timeline last monday - now ``` ## Export Finished Activities to iCalendar ### For today Example: ``` rtw dump ``` Example output: ``` BEGIN:VCALENDAR VERSION:2.0 PRODID:ICALENDAR-RS CALSCALE:GREGORIAN BEGIN:VEVENT DTSTAMP:20200616T184116Z DTEND:20200616T203000 DTSTART:20200616T160000 SUMMARY:build a spaceship UID:3bc8b3b6-d17b-4e1d-8323-2f55bfb14792 END:VEVENT END:VCALENDAR ``` Dump to ics file: `rtw dump > today.ics` ### For last week Example: ``` rtw dump lastweek ``` Dump to ics file: `rtw dump --lastweek > lastweek.ics` ### For a given date range Example: ``` rtw dump last monday - now ``` Dump to ics file: `rtw dump last monday - now > lastweek.ics` ## Continue Activity ### Continue last finished activity Example: ``` rtw continue ``` Example output: ``` Tracking write doc ``` ### Continue finished activity with id Example: ``` rtw continue 2 ``` Example output: ``` Tracking read twir ``` ## Delete Activity ### Delete Activity with id Example: ``` rtw delete 1 ``` Example output: ``` Deleted write doc Started 2019-12-25T19:43:00 Ended 2019-12-25T19:45:00 Total 00:02:00 ``` ## Track a finished activity ### Track a finished activity with dates Example: ``` rtw track 2019-12-25T19:43:00 - 2019-12-25T19:45:00 write doc ``` > please note the `-` separator Example output ``` Recorded write doc Started 2019-12-25T19:43:00 Ended 2019-12-25T19:45:00 Total 00:02:00 ``` ### Track a finished activity the same day Example: ``` rtw track 09:00 - 10:00 write doc ``` > please note the `-` separator Example output ``` Recorded write doc Started 2020-03-14T09:00:00 Ended 2020-03-14T10:00:00 Total 01:00:00 ``` ## Track an activity and provide a long description Example: ``` rtw track 9 - 10 breakfast -d "I ate delicious pancakes" rtw summary -d ``` output: ``` breakfast 2020-07-11T09:00:00 2020-07-11T10:00:00 01:00:00 I ate delicious pancakes ``` ## Display current status (for usage in scripts/status bars/prompts...) Example: ``` rtw start foo rtw status --format "{id} {ongoing} {start} {human_duration} {duration}" ``` output: ``` 0 foo 2021-04-20T19:31:09 2 hours ago 02:20:53 ``` ## For multitasking people Requires `deny_overlapping: false` in `rtw_config.json` ### Start (overlapping) activities Example: ``` rtw start work rtw start child question -d "answer how fish can breath under water" rtw ``` Output: ``` ./target/debug/rtw PicoJr Tracking work Total 00:03:03 Id 0 Tracking child question Total 00:01:25 Id 1 ``` ### Stop ongoing activity `--id` is only required when ongoing activities > 1. Example: ``` rtw stop --id 1 ``` Output: ``` PicoJr Recorded child question Started 2020-07-14T10:54:36 Ended 2020-07-14T10:57:23 Total 00:02:47 ``` stop the other remaining ongoing activity: ``` rtw stop ``` Output: ``` Recorded work Started 2020-07-14T10:52:58 Ended 2020-07-14T11:00:17 Total 00:07:18 ```