{b}kanbn sort "column"{b}

Sort a column in the index. The "column" value is optional if sorting a column interactively.

Some task attributes can be optionally transformed using case-insensitive regular expressions.
If a filter is specified, the matched text will be used when sorting.

If the filter regular expression has numbered capturing groups, the value of the first group will be used.
If the filter regular expression has named capturing groups, the value of all named groups will be concatenated.
If there are multiple matches, their values will be concatenated.

See docs/filtering-and-sorting.md for a full description of the sorting model.

Options:
  {b}kanbn sort --interactive{b}
  {b}kanbn sort -i{b}
    Sort a column interactively.

  {b}kanbn sort --save{b}
    Save the column sort settings in the index file (as a columnSorting option). This means that any tasks added to the column will be automatically sorted.
    If this option is not set, the column is sorted once and any saved sorting settings for the specified column will be removed.

  {b}kanbn sort --ascending{b}
  {b}kanbn sort -a{b}
    Sort the column in ascending order. This is the default order. This option can be set after each sorting field. If this option is set before any sorting fields, all fields will be sorted in ascending order.

  {b}kanbn sort --descending{b}
  {b}kanbn sort -z{b}
    Sort the column in descending order instead of default ascending order. This option can be set after each sorting field. If this option is set before any sorting fields, all fields will be sorted in descending order.

  {b}kanbn sort --id "filter"{b}
    Sort tasks by id.

  {b}kanbn sort --name "filter"{b}
  {b}kanbn sort -n "filter"{b}
    Sort tasks by name.

  {b}kanbn sort --description "filter"{b}
  {b}kanbn sort -d "filter"{b}
    Sort tasks by description.

  {b}kanbn sort --created{b}
    Sort tasks by created date.

  {b}kanbn sort --updated{b}
    Sort tasks by updated date.

  {b}kanbn sort --started{b}
    Sort tasks by started date.

  {b}kanbn sort --completed{b}
    Sort tasks by completed date.

  {b}kanbn sort --due{b}
  {b}kanbn sort -e{b}
    Sort tasks by due date.

  {b}kanbn sort --plannedStart{b}
    Sort tasks by planned start date.

  {b}kanbn sort --plannedFinish{b}
    Sort tasks by planned finish date.

  {b}kanbn sort --assigned{b}
    Sort tasks by assigned user name.

  {b}kanbn sort --progress{b}
    Sort tasks by progress.

  {b}kanbn sort --sub-task "filter"{b}
  {b}kanbn sort -s "filter"{b}
    Sort tasks by sub-tasks.

  {b}kanbn sort --count-sub-tasks{b}
    Sort tasks by the number of sub-tasks.

  {b}kanbn sort --tag "filter"{b}
  {b}kanbn sort -t "filter"{b}
    Sort tasks by tags.

  {b}kanbn sort --count-tags{b}
    Sort tasks by the number of tags.

  {b}kanbn sort --relation "filter"{b}
  {b}kanbn sort -r "filter"{b}
    Sort tasks by relations.

  {b}kanbn sort --count-relations{b}
    Sort tasks by the number of relations.

  {b}kanbn sort --comment "filter"{b}
    Sort tasks by comments.

  {b}kanbn sort --count-comments{b}
    Sort task by the number of comments.

  {b}kanbn sort --workload{b}
  {b}kanbn sort -w{b}
    Sort tasks by workload.

  {b}kanbn sort --overdue{b}
    Sort tasks by whether they are overdue. Ascending puts overdue tasks last.

  {b}kanbn sort --is-started{b}
    Sort tasks by whether they have a started date in their metadata.

  {b}kanbn sort --is-completed{b}
    Sort tasks by whether they have a completed date in their metadata.

  {b}kanbn sort --in-started-column{b}
    Sort tasks by whether they are in one of the board's startedColumns.

  {b}kanbn sort --in-completed-column{b}
    Sort tasks by whether they are in one of the board's completedColumns.

  {b}kanbn sort --<custom field name>{b}
    Sort tasks by a custom field value.

Examples:
  {b}kanbn sort "Todo" --created -z -n "Task (\\d+)" -w{b}
    Sort tasks in the "Todo" column first by created date in descending order, then by their name (filtered such that only numeric characters after the string "Task " are used) in ascending order, then by workload in ascending order

  {b}kanbn sort "Todo" -z -n --count-tags{b}
    Sort tasks in the "Todo" column first by name, then by the number of tags, all in descending order

  {b}kanbn sort "Todo" --overdue -z -e -a{b}
    Sort tasks in the "Todo" column so that overdue tasks come first, then by due date in ascending order

  {b}kanbn sort "column" --board "board-slug"{b}
  {b}kanbn sort "column" -b "board-slug"{b}
    Target a board other than the main one. Falls back to the KANBN_BOARD environment variable and
    then to the defaultBoard option. See {b}kanbn boards{b} for the list of boards.