Provided by: taskwarrior_2.6.2+dfsg-1build2_amd64 bug

NAME

       taskrc - Configuration details for the task(1) command

SYNOPSIS

       $HOME/.taskrc
       task rc:<directory-path>/.taskrc ...
       TASKRC=<directory-path>/.taskrc task ...
       XDG_CONFIG_HOME=<directory-path>/task/taskrc task ...

DESCRIPTION

       Taskwarrior  obtains  its  configuration  data  from  a file called .taskrc . This file is
       normally located in the user's home directory:

              $HOME/.taskrc

       The default location can be overridden using the rc: attribute when running task:

              $ task rc:<directory-path>/.taskrc ...

       or using the TASKRC environment variable:

              $ TASKRC=/tmp/.taskrc task ...

       Additionally, if no ~/.taskrc  exists,  taskwarrior  will  check  if  the  XDG_CONFIG_HOME
       environment variable is defined:

              $ XDG_CONFIG_HOME=~/.config task ...

       Individual options can be overridden by using the rc.<name>: attribute when running task:

              $ task rc.<name>:<value> ...

       or

              $ task rc.<name>=<value> ...

       If  Taskwarrior  is  run  without  an existing configuration file it will ask if it should
       create a default, sample .taskrc file in the user's home directory.

       The .taskrc file follows a very simple syntax defining name/value pairs:

              <name> = <value>

       There may be whitespace around <name>, '=' and <value>, and  it  is  ignored.   Whitespace
       within  the <value> is left intact.  Whitespace is not permitted in comma-separated lists.
       The entry must be on a single line, no continuations.  Values support UTF8 as well as JSON
       encoding, such as \uNNNN.

       Note  that  Taskwarrior  is flexible about the values used to represent Boolean items. You
       can use "1" to enable, anything else is interpreted as disabled.  The values "on",  "yes",
       "y" and "true" are currently supported but deprecated.

              include <file>

       There  may  be  whitespace  around  'include'  and  <file>. The file may be an absolute or
       relative path, and the special character '~' is expanded to mean $HOME. If  relative  path
       is  specified,  the  it  will  be  evaluated  as  relative  with  respect to the following
       directories (listed in order of precedence): 1.  the  current  working  directory  2.  the
       directory  containing the taskrc file 3. the directories set by the package manager (which
       usually contain
          pre-defined themes)

       Note that environment  variables  are  also  expanded  in  paths  (and  any  other  taskrc
       variables).

              # <comment>

       A  comment consists of the character '#', and extends from the '#' to the end of the line.
       There is no way to comment a multi-line block. There may be blank lines.

       Almost every value has a default setting, and an empty .taskrc file is one that makes  use
       of  every  default.  The contents of the .taskrc file therefore represent overrides of the
       default values. To remove a default value completely there must be an entry like this:

              <name> =

       This entry overrides the default value with a blank value.

EDITING

       You can edit your .taskrc file by hand if you wish, or you can use the  'config'  command.
       To permanently set a value in your .taskrc file, use this command:

              $ task config nag "You have more urgent tasks."

       To delete an entry, use this command:

              $ task config nag

       Taskwarrior  will  then  use  the  default  value. To explicitly set a value to blank, and
       therefore avoid using the default value, use this command:

              $ task config nag ""

       Taskwarrior will also display all your settings with this command:

              $ task show

       and in addition, will also perform a check of all the values in the file, warning  you  of
       anything it finds amiss.

NESTING CONFIGURATION FILES

       The .taskrc can include other files containing configuration settings by using the include
       statement:

              include <path/to/the/configuration/file/to/be/included>

       By using include files you can divide your  main  configuration  file  into  several  ones
       containing just the relevant configuration data like colors, etc.

       There are two excellent uses of includes in your .taskrc, shown here:

              include holidays.en-US.rc
              include dark-16.theme

       This includes two standard files that are distributed with Taskwarrior, which define a set
       of US holidays, and set up a 16-color theme to use, to color the reports and calendar.

ENVIRONMENT VARIABLES

       These environment variables override defaults, but not command-line arguments.

       TASKDATA=~/.task
              This overrides the default path for the Taskwarrior data files.

       TASKRC=~/.taskrc
              This overrides the default RC file.

       This environment variable will be checked if ~/.taskrc doesn't exist

       XDG_CONFIG_HOME=~/.config
              If set, taskwarrior will look for a $XDG_CONFIG_HOME/task/taskrc file

CONFIGURATION VARIABLES

       Valid variable names and their default values are:

   FILES
       data.location=$HOME/.task
              This is a path to the directory containing all the Taskwarrior files.  By  default,
              it is set up to be ~/.task, for example: /home/paul/.task

              Note that you can use the ~ shell meta character, which will be properly expanded.

              Note that the TASKDATA environment variable overrides this setting.

       hooks.location=$HOME/.task/hooks
              This is a path to the hook scripts directory. By default it is ~/.task/hooks.

       locking=1
              Determines  whether  to  use  file  locking  when  accessing  the  pending.data and
              completed.data files. Defaults to "1". Solaris users who store the data files on an
              NFS mount may need to set locking to "0". Note that there is danger in setting this
              value to "0" - another program (or another instance  of  task)  may  write  to  the
              task.pending file at the same time.

       gc=1   Can  be used to temporarily suspend garbage collection (gc), so that task IDs don't
              change. Note that this should be used in the form of a command line override  (task
              rc.gc=0  ...),  and not permanently used in the .taskrc file, as this significantly
              affects performance in the long term.

       hooks=1
              This master control switch enables hook script processing.  The  default  value  is
              '1', but certain extensions and environments may need to disable hooks.

       exit.on.missing.db=0
              When  set  to  '1'  causes  the  program  to  exit  if  the  database  (~/.task  or
              rc.data.location or TASKDATA override) is missing. Default value is '0'.

   TERMINAL
       detection=1
              Determines whether to use ioctl to establish the size of the window you are  using,
              for text wrapping.

       defaultwidth=80
              The  width of output used when auto-detection support is not available. Defaults to
              80. If set to 0, it is interpreted as  infinite  width,  therefore  with  no  word-
              wrapping;  this  is  useful when redirecting report output to a file for subsequent
              handling.

       defaultheight=24
              The height of output used when auto-detection support is not available. Defaults to
              24.  If  set  to  0,  it  is  interpreted  as  infinite height. This is useful when
              redirecting charts to a file for subsequent handling.

       avoidlastcolumn=0
              Causes the width of the terminal minus one to be  used  as  the  full  width.  This
              avoids  placing  color codes in the last column which can cause problems for Cygwin
              users. Default value is '0'.

       hyphenate=1
              Hyphenates lines when wrapping breaks occur mid-word. Default value is '1'.

       editor=editor
              Specifies which text editor you wish to use for when the task edit <ID> command  is
              used.  Taskwarrior will first look for this configuration variable. If found, it is
              used. Otherwise it will look for the  $VISUAL  or  $EDITOR  environment  variables,
              before it defaults to using "editor".

       reserved.lines=1
              This  is  the  number  of  lines reserved at the bottom of the screen for the shell
              prompt. This is only referenced when 'limit:page' is used.

   MISCELLANEOUS
       verbose=1|0|nothing|list...
              When set to "1" (the default), helpful explanatory comments are added to all output
              from Taskwarrior. Setting this to "0" means that you would see regular output.

              The  special  value  "nothing"  can be used to eliminate all optional output, which
              results in only the formatted data being shown, with nothing else. This  output  is
              most readily parsed and used by shell scripts.

              Alternatively,  you  can  specify  a  comma-separated list of verbosity tokens that
              control specific occasions when output is generated. This list may contain:

                  blank      Inserts extra blank lines in output, for clarity
                  header      Messages  that  appear  before   report   output   (this   includes
              .taskrc/.task overrides and the "[task next]" message)
                  footnote   Messages that appear after report output (mostly status messages and
              change descriptions)
                  label      Column labels on tabular reports
                  new-id     Provides feedback on any new task with IDs (and UUIDs for new  tasks
              with ID 0, such as new completed tasks).
                  new-uuid    Provides  feedback  on  any  new task with UUIDs. Overrides new-id.
              Useful for automation.
                  affected   Reports 'N tasks affected' and similar
                  edit       Used the verbose template for the 'edit' command
                  special    Feedback when applying special tags
                  project    Feedback about project status changes
                  sync       Feedback about sync
                  filter     Shows the filter used in the command
                  context    Show the current context. Displayed in footnote.
                  override   Notification when configuration options are overridden
                  recur      Notification when a new recurring task instance is created
                  default    Notifications  about  taskwarrior  choosing  to  perform  a  default
              action.

              The  tokens  "affected",  "new-id",  "new-uuid",  "project", "override" and "recur"
              imply "footnote".

              The token "default" implies "header".

              Note that the "1" setting is equivalent to all the tokens being specified, and  the
              "nothing" setting is equivalent to none of the tokens being specified.

              Here are the shortcut equivalents:

                  verbose=on
                  verbose=blank,header,footnote,label,new-id,affected,edit,special,project,sync,
              filter,override,recur

                  verbose=0
                  verbose=blank,label,new-id,edit

                  verbose=nothing
                  verbose=

              Those additional comments are sent to the standard error for header,  footnote  and
              project. The others are sent to standard output.

       confirmation=1
              May  be  "1"  or  "0", and determines whether Taskwarrior will ask for confirmation
              before deleting a task or performing the undo command. The default  value  is  "1".
              Consider leaving this enabled, for safety.

       allow.empty.filter=1
              An  empty  filter  combined with a write command is potentially a way to modify all
              tasks by mistake, and when this is detected,  confirmation  is  required.   Setting
              this to '0' means that it is an error to use a write command with no filter.

       indent.annotation=2
              Controls  the  number  of  spaces  to  indent  annotations  when  shown beneath the
              description field. The default value is "2".

       indent.report=0
              Controls the indentation of the entire report output. Default is "0".

       row.padding=0
              Controls left and right padding around each row of the report  output.  Default  is
              "0".

       column.padding=0
              Controls padding between columns of the report output. Default is "1".

       bulk=3 Is  a number, defaulting to 3. When this number or greater of tasks are modified in
              a single command, confirmation  will  be  required,  regardless  of  the  value  of
              confirmation variable. The special value bulk=0 is treated as an infinity.

              This is useful for preventing large-scale unintended changes.

       nag=You have more urgent tasks.
              This  may  be  a  string  of text, or blank.  It is used as a prompt when a task is
              started of completed, when there are other tasks with a  higher  urgency.   Default
              value  is:  'You  have  more  urgent  tasks'.  It is a gentle reminder that you are
              contradicting your own urgency settings.

       list.all.projects=0
              May be "1" or "0", and determines whether the  'projects'  command  lists  all  the
              project  names  you  have  used, or just the ones used in active tasks. The default
              value is "0".

       summary.all.projects=0
              If set to "1", shows all projects in the summary  report,  even  if  there  are  no
              pending tasks.  The default value is "0".

       complete.all.tags=1
              May  be  "1" or "0", and determines whether the tab completion scripts consider all
              the tag names you have used, or just the ones used in  active  tasks.  The  default
              value is "0".

       list.all.tags=1
              May  be  "1"  or  "0",  and determines whether the 'tags' command lists all the tag
              names you have used, or just the ones used in active tasks. The  default  value  is
              "0".

       print.empty.columns=1
              May  be  "1"  or  "0", and determines whether columns with no data for any task are
              printed. Defaults to "0".

       search.case.sensitive=1
              May be "1" or "0", and determines whether keyword lookup and substitutions  on  the
              description  and  annotations  are done in a case sensitive way. Defaults to "1" on
              most platforms. Defaults to "0" on Cygwin due to older regex library problems  with
              case-insensitivity.

       regex=1
              Controls whether regular expression support is enabled. The default value is "1".

       xterm.title=1
              Sets the xterm window title when reports are run. Defaults to "0".

       expressions=infix|postfix
              Sets  a  preference  for  infix expressions (1 + 2) or postfix expressions (1 2 +).
              Defaults to infix.

       json.array=1
              Determines whether the export command encloses the JSON output in '[...]' and  adds
              ','  after  each exported task object to create a properly-formed JSON array.  With
              json.array=0, export writes raw JSON objects to STDOUT, one per line.  Defaults  to
              "1".

       _forcecolor=1
              Taskwarrior shuts off color automatically when the output is not sent directly to a
              TTY. For example, this command:

                     $ task list > file

              will not use any color. To override this, use:

                     $ task rc._forcecolor=yes list > file

       Defaults to "0".

       active.indicator=*
              The character or string to show in the start.active column. Defaults to *.

       tag.indicator=+
              The character or string to show in the tag.indicator column. Defaults to +.

       dependency.indicator=D
              The character or string to show in the depends.indicator column. Defaults to D.

       uda.<name>.indicator=U
              The character or string to show in the <uda>.indicator column. Defaults to U.

       recurrence=1
              Controls whether recurrence is enabled, and whether  recurring  tasks  continue  to
              generate new task instances. Defaults to "1".

              If you are syncing multiple clients, then it is advised that you set 'recurrence=1'
              on your primary client,  and  'recurrence=0'  on  ALL  other  clients.  This  is  a
              workaround for a duplication bug.

       recurrence.confirmation=prompt
              Controls whether changes to recurring tasks propagates to other child tasks with or
              without  confirmation.  A  value  of  'yes'   means   propagate   changes   without
              confirmation.  A  value  of  'no'  means do not propagate changes and don't ask for
              confirmation. A value of 'prompt' prompts you every time. Defaults to 'prompt'.

       recurrence.indicator=R
              The character or string to show in the recurrence_indicator column. Defaults to R.

       recurrence.limit=1
              The number of future recurring tasks to show. Defaults to  1.  For  example,  if  a
              weekly recurring task is added with a due date of tomorrow, and recurrence.limit is
              set to 2, then a report will list 2 pending recurring tasks, one for tomorrow,  and
              one for a week from tomorrow.

       undo.style=side
              When  the 'undo' command is run, Taskwarrior presents a before and after comparison
              of the data. This can be in either the 'side' style, which compares values side-by-
              side  in  a  table,  or  'diff'  style,  which  uses a format similar to the 'diff'
              command.

       abbreviation.minimum=2
              Minimum length of any abbreviated  command/value.  This  means  that  "ve",  "ver",
              "vers",  "versi", "versio" will all equate to "version", but "v" will not.  Default
              is 2.

       debug=0
              Taskwarrior has a debug  mode  that  causes  diagnostic  output  to  be  displayed.
              Typically  this is not something anyone would want, but when reporting a bug, debug
              output can be useful. It can also help  explain  how  the  command  line  is  being
              parsed,  but  the  information  is  displayed  in a developer-friendly, not a user-
              friendly way.

              Turning debug on automatically sets debug.hooks=1, debug.parser=1  and  debug.tls=2
              if they do not already have assigned values. Defaults to "0".

       debug.hooks=0
              Controls  the  hook system diagnostic level. Level 0 means no diagnostics.  Level 1
              shows hook calls. Level 2 also shows exit status and I/O.

       debug.parser=0
              Controls the parser diagnostic level. Level 0 shows no diagnostics.  Level 1  shows
              the  final  parse tree.  Level 2 shows the parse tree from all phases of the parse.
              Level 3 shows expression evaluation details.

       debug.tls=0
              Controls the GnuTLS diagnostic level.  For  'sync'  debugging.  Level  0  means  no
              diagnostics. Level 9 is the highest. Level 2 is a good setting for debugging.

       obfuscate=0
              When  set  to  '1',  will  replace  all report text with 'xxx'.  This is useful for
              sharing report output in bug reports.  Default value is '0'.

       alias.rm=delete
              Taskwarrior supports command aliases. This alias provides an  alternate  name  (rm)
              for  the  delete command. You can use aliases to provide alternate names for any of
              the commands. Several commands you may use are actually  aliases  -  the  'history'
              report, for example, or 'export'.

       burndown.cumulative=1
              May  be "1" or "0", and controls the behaviour of the burndown command. When set to
              1, it sums up all completed tasks, otherwise they only get plotted in the  interval
              where the task was completed. Defaults to 1.

   DATES
       dateformat=Y-M-D

       dateformat.report=

       dateformat.holiday=YMD

       dateformat.edit=Y-M-D H:N:S

       dateformat.info=Y-M-D H:N:S

       dateformat.annotation=

       report.X.dateformat=Y-M-D
              This  is  a  string of characters that defines how Taskwarrior formats date values.
              The precedence order for the configuration  variable  is  report.X.dateformat  then
              dateformat.report then dateformat for formatting the due dates in reports.  If both
              report.X.dateformat and dateformat.report are  not  set  then  dateformat  will  be
              applied  to the date. Entered dates as well as all other displayed dates in reports
              are formatted according to dateformat.

              The default value is the ISO-8601 standard:  Y-M-D.  The  string  can  contain  the
              characters:

                     m  minimal-digit month,    for example 1 or 12
                     d  minimal-digit day,      for example 1 or 30
                     y  two-digit year,         for example 09 or 12
                     D  two-digit day,          for example 01 or 30
                     M  two-digit month,        for example 01 or 12
                     Y  four-digit year,        for example 2009 or 2015
                     a  short name of weekday,  for example Mon or Wed
                     A  long name of weekday,   for example Monday or Wednesday
                     b  short name of month,    for example Jan or Aug
                     B  long name of month,     for example January or August
                     v  minimal-digit week,     for example 3 or 37
                     V  two-digit week,         for example 03 or 37
                     h  minimal-digit hour,     for example 3 or 21
                     n  minimal-digit minutes,  for example 5 or 42
                     s  minimal-digit seconds,  for example 7 or 47
                     H  two-digit hour,         for example 03 or 21
                     N  two-digit minutes,      for example 05 or 42
                     S  two-digit seconds,      for example 07 or 47
                     J  three-digit Julian day, for example 023 or 365
                     j  Julian day,             for example 23 or 365
                     w  Week day,               for example 0 for Monday, 5 for Friday

              The  characters 'v', 'V', 'a' and 'A' can only be used for formatting printed dates
              (not to parse them).

              The string may also contain other characters to  act  as  spacers,  or  formatting.
              Examples for other values of dateformat:

                     d/m/Y  would use for input and output 24/7/2009
                     yMD    would use for input and output 090724
                     M-D-Y  would use for input and output 07-24-2009

              Examples for other values of dateformat.report:

                     a D b Y (V)   would emit "Fri 24 Jul 2009 (30)"
                     A, B D, Y     would emit "Friday, July 24, 2009"
                     wV a Y-M-D    would emit "w30 Fri 2009-07-24"
                     yMD.HN        would emit "110124.2342"
                     m/d/Y H:N     would emit "1/24/2011 10:42"
                     a D b Y H:N:S would emit "Mon 24 Jan 2011 11:19:42"

              Undefined  fields  are put to their minimal valid values (1 for month and day and 0
              for hour, minutes and seconds) when there is at least one more  global  date  field
              that  is  set.  Otherwise,  they  are set to the corresponding values of "now". For
              example:

                     8/1/2013  with m/d/Y   implies August 1, 2013 at midnight (inferred)
                     8/1 20:40 with m/d H:N implies August 1, 2013 (inferred) at 20:40

       date.iso=1
              Enables ISO-8601 date support.  The default value is "1".

   CALENDAR
       weekstart=Sunday
              Determines the day a week starts. Valid values  are  Sunday  or  Monday  only.  The
              default value is "Sunday".

       displayweeknumber=1
              Determines  if  week  numbers are displayed when using the "task calendar" command.
              The week number is dependent on the day a week starts. The default value is "1".

       due=7  This is the number of days into the future that define when a  task  is  considered
              due, and is colored accordingly. The default value is 7.

       calendar.details=sparse
              If set to "full" running "task calendar" will display the details of tasks with due
              dates that fall into the calendar period. The corresponding  days  will  be  color-
              coded in the calendar. If set to "sparse" only the corresponding days will be color
              coded and no details will be displayed. The displaying of due dates with details is
              turned off by setting the variable to "none". The default value is "sparse".

       calendar.details.report=list
              The  report to run when displaying the details of tasks with due dates when running
              the "task calendar" command. The default value is "list".

       calendar.offset=0
              If "1" the first month in the calendar report is effectively changed by the  offset
              value specified in calendar.offset.value. It defaults to "0".

       calendar.offset.value=-1
              The  offset  value  to apply to the first month in the calendar report. The default
              value is "-1".

       calendar.holidays=none
              If set to full running "task calendar" will display holidays  in  the  calendar  by
              color-coding  the  corresponding  days. A detailed list with the dates and names of
              the holidays is also shown. If set to sparse only the days are color-coded  and  no
              details on the holidays will be displayed. The displaying of holidays is turned off
              by setting the variable to none. The default value is "none".

       calendar.legend=1
              Determines whether the calendar legend is displayed. The default value is "1".

       calendar.monthsperline=N
              Determines how many months the "task calendar" command renders across  the  screen.
              Defaults  to  however  many  will  fit. If more months than will fit are specified,
              Taskwarrior will only show as many that will fit.

   JOURNAL ENTRIES
       journal.time=0
              May be "1" or "0", and determines whether the 'start' and  'stop'  commands  should
              record an annotation when being executed. The default value is "0". The text of the
              corresponding annotations is controlled by:

       journal.time.start.annotation=Started task
              The text of the annotation that is recorded when executing the  start  command  and
              having set journal.time.

       journal.time.stop.annotation=Stopped task
              The  text  of  the  annotation that is recorded when executing the stop command and
              having set journal.time.

       journal.info=1
              When enabled, this setting causes a change log of each task to be displayed by  the
              'info' command. Default value is "1".

   HOLIDAYS
       Holidays  are  entered  either directly in the .taskrc file or via an include file that is
       specified in .taskrc. For single-day holidays the name and the  date  is  required  to  be
       given:

                     holiday.towel.name=Day of the towel
                     holiday.towel.date=20100525

       For  holidays  that  span a range of days (i.e. vacation), you can use a start date and an
       end date:

                     holiday.sysadmin.name=System Administrator Appreciation Week
                     holiday.sysadmin.start=20100730
                     holiday.sysadmin.end=20100805

              Dates are to  be  entered  according  to  the  setting  in  the  dateformat.holiday
              variable.

              The following holidays are computed automatically: Good Friday (goodfriday), Easter
              (easter),  Easter   Monday   (eastermonday),   Ascension   (ascension),   Pentecost
              (pentecost). The date for these holidays is the given keyword:

                     holiday.eastersunday.name=Easter
                     holiday.eastersunday.date=easter

       Note that the Taskwarrior distribution contains example holiday files that can be included
       like this:

                     include holidays.en-US.rc

   DEPENDENCIES
       dependency.reminder=1
              Determines whether dependency chain violations generate reminders.

       dependency.confirmation=1
              Determines whether dependency chain repair requires confirmation.

   COLOR CONTROLS
       color=1
              May be "1" or "0". Determines whether Taskwarrior uses color. When  "0",  will  use
              dashes (-----) to underline column headings.

       fontunderline=1
              Determines  if font underlines or ASCII dashes should be used to underline headers,
              even when color is enabled.

       Taskwarrior has a number of coloration rules. They correspond to a particular attribute of
       a  task,  such  as  it being due, or being active, and specifies the automatic coloring of
       that task. A list of valid colors, depending on your terminal, can be obtained by  running
       the command:

              task colors

              Note  that  no  default values are listed here - the defaults now correspond to the
              dark-256.theme (Linux) and dark-16.theme  (other)  theme  values.   The  coloration
              rules are as follows:

              color.due.today Task is due today
              color.active Task is started, therefore active.
              color.scheduled Task is scheduled, therefore ready for work.
              color.until Task has an expiration date.
              color.blocking Task is blocking another in a dependency.
              color.blocked Task is blocked by a dependency.
              color.overdue Task is overdue (due some time prior to now).
              color.due Task is coming due.
              color.project.none Task does not have an assigned project.
              color.tag.none Task has no tags.
              color.tagged Task has at least one tag.
              color.recurring Task is recurring.
              color.completed Task is completed.
              color.deleted Task is deleted.

              To  disable  a  coloration  rule  for  which  there  is a default, set the value to
              nothing, for example:
                     color.tagged=

              By default, colors produced by rules blend. This has  the  advantage  of  conveying
              additional  information,  by  producing  combinations  that  are  not  used  by any
              particular rule directly.

              However, color  blending  can  produce  highlighting  combinations  which  are  not
              desired. In such cases, use the following option to disable this behaviour:

       rule.color.merge=1
              Can be "1" or "0". When "0", disables merging of colors produced by different color
              rules. Use if your color  scheme  produces  unpleasing  foreground  and  background
              combinations.

              See the task-color(5) man pages for color details.

       Certain attributes like tags, projects and keywords can have their own coloration rules.

       color.tag.X=yellow
              Colors any task that has the tag X.

       color.project.X=on green
              Colors any task assigned to project X.

       color.keyword.X=on blue
              Colors any task where the description or any annotation contains X.

       color.uda.X=on green
              Colors any task that has the user defined attribute X.

       color.uda.X.VALUE=on green
              Colors any task that has the user defined attribute X set to VALUE.

       color.uda.X.none=on green
              Colors any task that does not have the user defined attribute X.

       color.error=white on red
              Colors any of the error messages.

       color.warning=bold red
              Colors any of the warning messages.

       color.header=green
              Colors any of the messages printed prior to the report output.

       color.footnote=green
              Colors any of the messages printed last.

       color.summary.bar=on green
              Colors the summary progress bar. Should consist of a background color.

       color.summary.background=on black
              Colors the summary progress bar. Should consist of a background color.

       color.calendar.today=black on cyan
              Color of today in calendar.

       color.calendar.due=black on green
              Color of days with due tasks in calendar.

       color.calendar.due.today=black on magenta
              Color of today with due tasks in calendar.

       color.calendar.overdue=black on red
              Color of days with overdue tasks in calendar.

       color.calendar.scheduled=black on orange
              Color of days with scheduled tasks in calendar.

       color.calendar.weekend=bright white on black
              Color of weekend days in calendar.

       color.calendar.holiday=black on bright yellow
              Color of holidays in calendar.

       color.calendar.weeknumber=black on white
              Color of weeknumbers in calendar.

       color.label=
              Colors the report labels. Defaults to not use color.

       color.label.sort=
              Colors the report labels for sort columns. Defaults to color.label.

       color.alternate=on rgb253
              Color of alternate tasks.  This is to apply a specific color to every other task in
              a report, which can make it easier to visually separate tasks. This  is  especially
              useful  when  tasks  are  displayed over multiple lines due to long descriptions or
              annotations.

       color.history.add=on red
       color.history.done=on green
       color.history.delete=on yellow
              Colors the bars on the ghistory report graphs. Defaults to red,  green  and  yellow
              bars.

       color.burndown.pending=on red
       color.burndown.started=on yellow
       color.burndown.done=on green
              Colors  the  bars on the burndown reports graphs. Defaults to red, green and yellow
              bars.

       color.undo.before=red
       color.undo.after=green
              Colors used by the undo command, to indicate the values both  before  and  after  a
              change that is to be reverted.

       color.sync.added=green
       color.sync.changed=yellow
       color.sync.rejected=red
              Colors the output of the sync command.

       rule.precedence.color=due.today,active,blocking,blocked,overdue,due,
              scheduled,keyword.,project.,tag.,uda.,recurring, tagged,completed,deleted
              This  setting  specifies the precedence of the color rules, from highest to lowest.
              Note that the prefix 'color.' is omitted (for brevity), and that any wildcard value
              (color.tag.XXX)  is shortened to 'tag.', which places all specific tag rules at the
              same precedence, again for brevity.

       color.debug=green
              Colors all debug output, if enabled.

   URGENCY
       The urgency calculation uses a  polynomial  with  several  terms,  each  of  which  has  a
       configurable coefficient. Those coefficients are:

       urgency.blocking.coefficient=8.0
              Urgency coefficient for blocking tasks
       urgency.blocked.coefficient=-5.0
              Urgency coefficient for blocked tasks
       urgency.due.coefficient=12.0
              Urgency coefficient for due dates
       urgency.waiting.coefficient=-3.0
              Urgency coefficient for waiting status
       urgency.active.coefficient=4.0
              Urgency coefficient for active tasks
       urgency.scheduled.coefficient=5.0
              Urgency coefficient for scheduled tasks
       urgency.project.coefficient=1.0
              Urgency coefficient for projects
       urgency.tags.coefficient=1.0
              Urgency coefficient for tags
       urgency.annotations.coefficient=1.0
              Urgency coefficient for annotations
       urgency.age.coefficient=2.0
              Urgency coefficient for the age of tasks
       urgency.age.max=365
              Maximum  age  in days. After this number of days has elapsed, the urgency of a task
              won't increase any more because of aging.
       urgency.user.tag.<tag>.coefficient=...
              Specific tag coefficient.
       urgency.user.tag.next.coefficient=15.0
              Urgency coefficient for tag 'next'.
       urgency.user.project.<project>.coefficient=...
              Specific project coefficient.
       urgency.user.keyword.<keyword>.coefficient=...
              Specific description keyword coefficient.
       urgency.uda.<name>.coefficient=...
              Presence/absence of UDA data.
       urgency.uda.<name>.<value>.coefficient=...
              Specific value of UDA data.

       The coefficients reflect the relative importance of  the  various  terms  in  the  urgency
       calculation.  These  are default values, and may be modified to suit your preferences, but
       it is important that you carefully consider any modifications.

       urgency.inherit=0
              Not actually a coefficient.  When  enabled,  blocking  tasks  inherit  the  highest
              urgency  value  found  in  the  tasks  they block. This is done recursively.  It is
              recommended to set urgency.blocking.coefficient and urgency.blocked.coefficient  to
              0.0 in order for this setting to be the most useful.

   DEFAULTS
       default.project=foo
              Provides a default project name for the task add command, if you don't specify one.
              The default is blank.

       default.due=...
              Provides a default due date for the task add command, if you don't specify one. You
              can  use  a date, or a duration value which is assumed to be relative to 'now'. The
              default is blank.

       default.scheduled=...
              Provides a default scheduled date for the task add command, if  you  don't  specify
              one.  You  can  use  a date, or a duration value which is assumed to be relative to
              'now'. The default is blank.

       uda.<name>.default=...
              Provides default values for UDA fields when using the  task  add  command,  if  you
              don't specify values. The default is blank.

       default.command=next
              Provides  a  default  command that is run every time Taskwarrior is invoked with no
              arguments. For example, if set to:

                     default.command=project:foo list

              then Taskwarrior  will  run  the  "project:foo  list"  command  if  no  command  is
              specified. This means that by merely typing

                     $ task
                     [task project:foo list]

                     ID Project Pri Description
                      1 foo     H   Design foo
                      2 foo         Build foo

   REPORTS
       The  reports can be customized by using the following configuration variables.  The output
       columns, their labels and the sort order can be set using the corresponding variables  for
       each report. Each report name is used as a "command" name. For example

       task overdue

       report.X.description
              The description for report X when running the "task help" command.

       report.X.columns
              This  is  a  comma-separated  list  of  columns  and formatting specifiers. See the
              command 'task columns' for a full list of options and examples.

       report.X.context
              A boolean value representing whether the given report should  respect  (apply)  the
              currently  active context. See CONTEXT section for details about context.  Defaults
              to 1.

       report.X.labels
              The labels for each column that will be used when generating report X.  The  labels
              are a comma separated list.

       report.X.sort
              The  sort order of the tasks in the generated report X. The sort order is specified
              by using the column ids post-fixed by a "+" for ascending sort order or a  "-"  for
              descending sort order. The sort IDs are separated by commas.  For example:

                  report.list.sort=due+,priority-,start.active-,project+

              Additionally, after the "+" or "-", there can be a solidus "/" which indicates that
              there are breaks after the column values change. For example:

                  report.minimal.sort=project+/,description+

              This sort order now specifies that there is a listing break between each project. A
              listing break is simply a blank line, which provides a visual grouping.

              A  special  sort  value  of "none" indicates that no sorting is required, and tasks
              will be presented in the order (if any) in which they are selected.

       report.X.filter
              This adds a filter to the report X so that only tasks matching the filter  criteria
              are displayed in the generated report.

              There  is a special case for 'report.timesheet.filter', which may be specified even
              though the 'timesheet' report is not very customizable.

       report.X.dateformat
              This adds a dateformat to the report X that will be used by the "due date"  column.
              If  it is not set then dateformat.report and dateformat will be used in this order.
              See the DATES section for details on the sequence placeholders.

       report.X.annotations
              This adds the possibility to control the output of annotations  for  a  task  in  a
              report.   Deprecated.   Use   the   description   column   with   a  format  (e.g.,
              description.count) instead.

       Taskwarrior comes with a number of predefined reports, which are:

       next   Lists the most important tasks.

       long   Lists all pending tasks and all data, matching the specified criteria.

       list   Lists all tasks matching the specified criteria.

       ls     Short listing of all tasks matching the specified criteria.

       minimal
              Minimal listing of all tasks matching the specified criteria.

       newest Shows the newest tasks.

       oldest Shows the oldest tasks.

       overdue
              Lists overdue tasks matching the specified criteria.

       active Lists active tasks matching the specified criteria.

       completed
              Lists completed tasks matching the specified criteria.

       recurring
              Lists recurring tasks matching the specified criteria.

       waiting
              Lists all waiting tasks matching the specified criteria.

       all    Lists all tasks matching the specified criteria.

       blocked
              Lists all tasks that have dependencies.

   USER DEFINED ATTRIBUTES
       User defined attributes (UDAs) are an extension mechanism that allows you  to  define  new
       attributes  for  Taskwarrior  to  store  and  display.  One  such example is an 'estimate'
       attribute that could be used  to  store  time  estimates  associated  with  a  task.  This
       'estimate'  attribute  is not built in to Taskwarrior, but with a few simple configuration
       settings you can instruct Taskwarrior to store this item, and provide  access  to  it  for
       custom reports and filters.

       This allows you to augment Taskwarrior to accommodate your workflow, or bend the rules and
       use Taskwarrior to store and synch data that is not necessarily task-related.

       One important restriction is  that  because  this  is  an  open  system  that  allows  the
       definition  of  any  new  attribute,  Taskwarrior  cannot  understand  the meaning of that
       attribute. So while Taskwarrior will faithfully store, modify,  report,  sort  and  filter
       your  UDA, it does not understand anything about it. For example if you define a UDA named
       'estimate', Taskwarrior will not know that this value is weeks, hours, minutes, money,  or
       some other resource count.

       uda.<name>.type=string|numeric|date|duration
              Defines a UDA called '<name>', of the specified type.

       uda.<name>.label=<column heading>
              Provides a default report label for the UDA called '<name>'.

       uda.<name>.values=A,B,C
              For  type  'string'  UDAs  only, this provides a comma-separated list of acceptable
              values. In this example, the '<name>' UDA may only contain values 'A', 'B', or 'C',
              but may also contain no value.

              Note  that  the  order  of  the value is important, and denotes the sort order from
              highest ('A') to lowest ('C').

              Note that a blank value is permitted.

       uda.<name>.default=...
              Provides a default value for the UDA called '<name>'.

       Example 'estimate' UDA
              This example shows an 'estimate' UDA that stores specific values for the size of  a
              task.  Note the blank value after 'trivial'.

              uda.estimate.type=string
              uda.estimate.label=Size Estimate
              uda.estimate.values=huge,large,medium,small,trivial,

              Note that the value are sorted

                  huge > large > medium > small > trivial > ''

   CONTEXT
       Context  setting  is  a  mechanism  which  allows the user to set a permanent filter, thus
       avoiding the need to specify one filter repeatedly. More details on usage can be found  in
       the task(1) man page.

       The  current  context  is  stored in the .taskrc file, along with definitions for all user
       provided contexts.

       context=<name>
              Stores the value of the currently active context.

       context.<name>.read=<filter>
       context.<name>.write=<modifications>
              Stores the definition of the read or write  context  with  the  name  <name>.  Read
              context is the default filter applied when the context is active. The write context
              are the default modifications applied to newly added  tasks  when  the  context  is
              active.

       context.<name>.rc.<key>=<value>
              The rc type allows to override any configuration parameter for the current context,
              e.g. if the default command for the context home should be changed to  home_report,
              the following statement could be added:

              context.home.rc.default.command=home_report

   SYNC
       These configuration settings are used to connect and sync tasks with the task server.

       taskd.server=<host>:<port>
              Specifies  the hostname and port of the Taskserver. Hostname may be an IPv4 or IPv6
              address, or domain. Port is an integer.

       taskd.credentials=<organization>/<user>/<key>
              User identification for the Taskserver, which includes a private key.

       taskd.certificate=<path>
              Specifies the path to the client  certificate  used  for  identification  with  the
              Taskserver.

       taskd.key=<path>
              Specifies  the  path  to  the  client key used for encrypted communication with the
              Taskserver.

       taskd.ca=<path>
              Specifies the path to the CA certificate in the event that your Taskserver is using
              a self-signed certificate. Optional.

       taskd.trust=strict|ignore hostname|allow all
              This  settings  allows you to override the trust level when server certificates are
              validated. With "allow all", the server certificate is trusted automatically.  With
              "ignore  hostname", the server certificate is verified but the hostname is ignored.
              With "strict", the server certificate is  verified.   Default  is  "strict",  which
              requires full validation.

       taskd.ciphers=NORMAL
              Override  of the cipher selection. The set of ciphers used by TLS may be controlled
              by both server and client. There must be some overlap  between  client  and  server
              supported  ciphers, or communication cannot occur.  Default is "NORMAL". See GnuTLS
              documentation for full details.

CREDITS & COPYRIGHTS

       Copyright (C) 2006 - 2021 T. Babej, P. Beckingham, F. Hernandez.

       This man page was originally written by Federico Hernandez.

       Taskwarrior      is      distributed      under      the      MIT       license.       See
       https://www.opensource.org/licenses/mit-license.php for more information.

SEE ALSO

       task(1), task-color(5), task-sync(5)

       For more information regarding Taskwarrior, see the following:

       The official site at
              <https://taskwarrior.org>

       The official code repository at
              <https://github.com/GothenburgBitFactory/taskwarrior>

       You can contact the project by emailing
              <support@GothenburgBitFactory.org>

REPORTING BUGS

       Bugs in Taskwarrior may be reported to the issue-tracker at
              <https://github.com/GothenburgBitFactory/taskwarrior/issues>