Smos Logo Smos

A comprehensive self-management system

Work report

Documentation about the smos-query work command, for the contextual work report

The work report is the most important report that you will use. This report shows you your agenda for the day, and the next actions that you can perform in your current context, as well as any warnings that you need to see about the state of your workflow.

Contexts

For context-based work reports, you will first need contexts. For example, you can use these in your config file:

work:
  contexts:
    home: 'ancestor:tag:home'
    office: 'ancestor:tag:office'
    airplane: 'tag:offline'

These specify that, when you're at home, you can only do the tasks that are tagged 'home' or whose parents are tagged as 'home'.

Advanced work reports

You can also configure checks, collumns and a sorter for this report as follows:

work:
  checks:
    - 'property:timewindow'
  columns:
    - 'file'
    - 'state'
    - 'header'
    - 'property:timewindow'
  sorter: 'reverse:property-as-time:timewindow'

Here we configure smos-query to warn us if any of the entries that should be reported is missing a timewindow property. We also specify that the collumns in the report should be the file, the todo state, the header and the timewindow property for each entry. The last line configures smos-query to sort these entries by their timewindow property value. (Checks, columns and sorters are Standard Arguments.)

Reference

Arguments

Usage: smos-query work [CONTEXT] [TIME_FILTER] [-f|--filter FILTER] 
                       [--add-column|--project PROJECTION] [--sort SORTER] 
                       [--hide-archived | (-a|--show-archived)] 
                       [--waiting-threshold ARG] [--stuck-threshold ARG]
  Show the work overview

Available options:
  CONTEXT                  The context that you are in
  TIME_FILTER              A filter to filter by time
  -f,--filter FILTER       A filter to filter entries by
  --add-column,--project PROJECTION
                           A projection to project entries onto fields
  --sort SORTER            A sorter to sort entries by
  --hide-archived          ignore archived files.
  -a,--show-archived       Don't ignore archived files.
  --waiting-threshold ARG  The threshold at which to color waiting entries red
  --stuck-threshold ARG    The threshold at which to color stuck projects red
  -h,--help                Show this help text

Environment

This command does not use any extra environment variables.

Configuration

# Configuration
work: # optional
  # WorkReportConfiguration
  base-filter: # optional
    # The base work filter
    <string>
  checks: # optional
    - # Checks for the work report
      <string>
  contexts: # optional
    # Contexts for the work report
    <key>: <string>
  time-filter: # optional
    # The property to use to filter by time
    <string>
  columns: # optional
    - # The columns in the report
      <string>
  sorter: # optional
    # The sorter to use to sort the rows
    <string>