The smos editor comes with some handy companion tools. smos-query is one of those and it is a query tool for your .smos files.

File structure

The smos-query tool operates in the workflow directory. See the directories documentation for more information. The smos-query tool will only consider the contents of the workflow directory for its functionality.

Usage: smos-query COMMAND [--config-file FILEPATH] [--workflow-dir FILEPATH] 
                  [--archive-dir FILEPATH] [--projects-dir FILEPATH] 
                  [--archived-projects-dir FILEPATH]
  
  Smos Query Tool version: 0.6.0
  
  Oldest parseable Smos data format version: 0.0.0
  Newest parseable Smos data format version: 1.0.0

Available options:
  -h,--help                Show this help text
  --config-file FILEPATH   The config file to use
  --workflow-dir FILEPATH  The workflow directory to use
  --archive-dir FILEPATH   The archive directory to use
  --projects-dir FILEPATH  The projects directory to use
  --archived-projects-dir FILEPATH
                           The archived projects directory to use

Available commands:
  entry                    Select entries based on a given filter
  report                   Run preconfigured reports
  work                     Show the work overview
  waiting                  Print the "WAITING" tasks
  next                     Print the next actions
  clock                    Print the clock table
  agenda                   Print the agenda
  projects                 Print the projects overview
  stuck                    Print the stuck projects overview
  log                      Print a log of what has happened.
  stats                    Print the stats actions and warn if a file does not
                           have one.
  tags                     Print all the tags that are in use

Available environment variables:

  SMOS_ARCHIVED_PROJECTS_DIR
                         Archived projects directory
  SMOS_ARCHIVE_DIR
                         Archive directory
  SMOS_CONFIG_FILE
                         Workflow directory
  SMOS_IGNORE_ARCHIVE
                         whether to ignore the archive
  SMOS_PROJECTS_DIR
                         Projects directory
  SMOS_WORKFLOW_DIR
                         Workflow directory

# Configuration
workflow-dir: # optional
  # or <null>
  # The workflow directory
  <string>
archive-dir: # optional
  # or <null>
  # The archive directory
  <string>
projects-dir: # optional
  # or <null>
  # The projects directory
  <string>
archived-projects-dir: # optional
  # or <null>
  # The archived projects directory
  <string>
waiting: # optional
  # or <null>
  # The waiting report configuration
  # WaitingReportConfiguration
  threshold: # optional
    [ # Time string: 2s, 3m, 4h, 5d, 6w, ...
      <string>
    , # Interpreted as a number of days
      <number>
    ]
stuck: # optional
  # or <null>
  # The stuck projects report configuration
  # StuckReportConfiguration
  threshold: # optional
    [ # Time string: 2s, 3m, 4h, 5d, 6w, ...
      <string>
    , # Interpreted as a number of days
      <number>
    ]
work: # optional
  # or <null>
  # The work report configuration
  # WorkReportConfiguration
  base-filter: # optional
    # or <null>
    # The base work filter
    <string>
  checks: # optional
    - # or <null>
      # Checks for the work report
      <string>
  contexts: # optional
    # or <null>
    # Contexts for the work report
    <key>: <string>
  time-filter: # optional
    # or <null>
    # The property to use to filter by time
    <string>
  columns: # optional
    - # or <null>
      # The columns in the report
      <string>
  sorter: # optional
    # or <null>
    # The sorter to use to sort the rows
    <string>
# Configuration
hide-archive: # optional
  # or <null>
  # Whether or not to consider the archive, by default
  <boolean>
report: # optional
  # or <null>
  # Prepared report config
  # PreparedReportConfiguration
  reports: # optional
    # or <null>
    # Custom reports
    <key>: # PreparedReport
      description: # optional
        # or <null>
        # A description of the report
        <string>
      filter: # optional
        # or <null>
        # The entry filter to get the results in the report
        <string>
      columns: # optional
        - # or <null>
          # The columns of the report
          <string>
      sorter: # optional
        # or <null>
        # The sorter to sort the rows of the report by
        <string>
      hide-archive: # optional
        # or <null>
        # Whether to consider the archive for the report
        <boolean>
colour: # optional
  # or <null>
  # Colour config
  # ColourConfiguration
  background: # optional
    [ null
    , [ [ <string>
        , # Set this to a number between 0 and 255 that represents the colour that you want from the 8-bit colour schema.
          # See this overview on wikipedia for more information:
          # https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit
          <number>
        , # Colour24Bit
          red: # required
            # The red component, [0..255]
            <number>
          green: # required
            # The green component, [0..255]
            <number>
          blue: # required
            # The blue component, [0..255]
            <number>
        ]
      , # Bicolour
        even: # optional
          [ <string>
          , # Set this to a number between 0 and 255 that represents the colour that you want from the 8-bit colour schema.
            # See this overview on wikipedia for more information:
            # https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit
            <number>
          , # Colour24Bit
            red: # required
              # The red component, [0..255]
              <number>
            green: # required
              # The green component, [0..255]
              <number>
            blue: # required
              # The blue component, [0..255]
              <number>
          ]
        odd: # optional
          [ <string>
          , # Set this to a number between 0 and 255 that represents the colour that you want from the 8-bit colour schema.
            # See this overview on wikipedia for more information:
            # https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit
            <number>
          , # Colour24Bit
            red: # required
              # The red component, [0..255]
              <number>
            green: # required
              # The green component, [0..255]
              <number>
            blue: # required
              # The blue component, [0..255]
              <number>
          ]
      ]
    ]