FreeBSD Manual Pages
tasksh(1) User Manuals tasksh(1) NAME tasksh - Interactive taskwarrior shell SYNOPSIS tasksh tasksh --version DESCRIPTION Tasksh can be used to create a more immersive taskwarrior environment. Any task command you run outside the shell can also be run inside the shell, without the need to prefix every command with "task". When built with libreadline, tasksh provides command editing and history. Tasksh has an integrated 'review' command that leads you through an inter- active review session. Tasksh supports all recent versions of Taskwarrior. COMMANDS Tasksh supports the following commands. All other commands are passed in- tact to Taskwarrior. diagnostics Displays settings pertinent to tasksh, for diagnosing problems. exec <commands> This command allows you to run shell commands from within Tasksh. This is ideal for accessing man pages such as this. The '!' command can be used in place of the 'exec' keyword. Once the command is run, control returns to Tasksh. exit/quit These commands cause tasksh to terminate, returning you to your sys- tem shell. help Shows a summary of commands, and how to obtain help. review [N] Begins an interactive review session, where you can mark tasks as reviewed, edit them using your text editor, provide modification commands, or skip them. You can terminate a review session at any time, and the next review session will resume at the right place. To find tasks needing review, the '_reviewed' custom report is cre- ated and run, which filters tasks that have a missing 'reviewed' UDA date, or have not been reviewed for a week. This means that if you run a review session to completion, there will be no need to review again for a week, and the review command will simply do nothing until then. The one week review cycle is defined by the '_reviewed' custom re- port, which can be modified if you prefer a monthly review cycle. If 'N' is provided, the session is limited to reviewing only N tasks. Note: requires Taskwarrior 2.5.0 or later. For full details, see: <https://taskwarrior.org/docs/review.html> USAGE Here is an example tasksh session. $ tasksh task> projects Project Tasks Pri:None Pri:L Pri:M Pri:H ------- ----- -------- ----- ----- ----- 7 7 0 0 0 home 2 2 0 0 0 party 6 3 0 0 3 3 projects (15 tasks) task> tags Tag Count mall 2 1 tag (15 tasks) task> list ID Project Pri Due Active Age Description --------------------------------------------------------------------- 2 party H 10/17/2015 2 hrs Select and book a venue 5 party H 10/22/2015 2 hrs Design invitations 9 home 10/31/2015 1 hr Pay rent 3 party 2 hrs Mail invitations 4 party 2 hrs Select a caterer 6 party 2 hrs Print invitations 8 tasks task> quit $ CONFIGURATION Tasksh piggybacks on Taskwarrior's .taskrc configuration file, and refers to settings there. If you use a non-standard location for your .task data- base , and .taskrc file, Tasksh will not find them unless you set the TASK- DATA and TASKRC environment variables. See 'man taskrc' for more details. The review command storeN a UDA ('reviewed') and report definition ('_re- viewed'). tasksh.autoclear=1 If set to "1", causes each tasksh command to be preceded by a 'clear screen' and cursor reset. Default is "0". CREDITS & COPYRIGHTS Copyright (C) 2006 - 2017 P. Beckingham, F. Hernandez. This man page was originally written by Federico Hernandez. Tasksh is distributed under the MIT license. See http://www.open- source.org/licenses/mit-license.php for more information. SEE ALSO task(1), For more information regarding tasksh, see the following: The official site at <http://taskwarrior.org/tools> The official code repository at <https://git.tasktools.org/scm/ex/tasksh.git> You can contact the project by emailing <support@tasktools.org> REPORTING BUGS Bugs in tasksh may be reported to the issue-tracker at <http://bug.tasktools.org> tasksh 1.2.0 2017-05-10 tasksh(1)
NAME | SYNOPSIS | DESCRIPTION | COMMANDS | USAGE | CONFIGURATION | CREDITS & COPYRIGHTS | SEE ALSO | REPORTING BUGS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tasksh&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>