{b}kanbn edit "task-id"{b}
{b}kanbn e "task-id"{b}

Edit an existing task and set its 'updated' date. This command can be used to rename and move tasks as well.

Options:
  {b}kanbn edit "task-id" --interactive{b}
  {b}kanbn edit "task-id" -i{b}
    Edit a task interactively.

  {b}kanbn edit "task-id" --name "name"{b}
  {b}kanbn edit "task-id" -n "name"{b}
    Modify a task name.

  {b}kanbn edit "task-id" --description "description"{b}
  {b}kanbn edit "task-id" -d "description"{b}
    Modify a task description.

  {b}kanbn edit "task-id" --column "column"{b}
  {b}kanbn edit "task-id" -c "column"{b}
    Move a task to a different column.

  {b}kanbn edit "task-id" --due "date"{b}
  {b}kanbn edit "task-id" -e "date"{b}
    Modify a task due date. The date can be in (almost) any format.

  {b}kanbn edit "task-id" --plannedStart "date"{b}
    Modify the planned start date used for gantt scheduling. The date can be in (almost) any format.

  {b}kanbn edit "task-id" --plannedFinish "date"{b}
    Modify the planned finish date used for gantt scheduling. The date can be in (almost) any format.

  {b}kanbn edit "task-id" --progress N{b}
    Modify a task's progress. This should be a number between 0 (not started) and 1 (complete).

  {b}kanbn edit "task-id" --assigned "name"{b}
    Modify a task assigned user name. If this option is left blank, the task is assigned to the current user.
    The current user comes from KANBN_USER or your git identity, canonicalised against the {b}contributors{b} list if the workspace has one - see {b}kanbn contributors --help{b}.

  {b}kanbn edit "task-id" --remove-sub-task "sub-task"{b}
    Remove a sub-task.

  {b}kanbn edit "task-id" --sub-task "sub-task"{b}
  {b}kanbn edit "task-id" -s "sub-task"{b}
    Add or modify a sub-task. The sub-task text can be prefixed with "[ ] " or "[x] " to set the completion status.

  {b}kanbn edit "task-id" --remove-tag "tag"{b}
    Remove a tag.

  {b}kanbn edit "task-id" --tag "tag"{b}
  {b}kanbn edit "task-id" -t "tag"{b}
    Add a tag.

  {b}kanbn edit "task-id" --remove-relation "relation"{b}
    Remove a relation.

  {b}kanbn edit "task-id" --relation "relation"{b}
  {b}kanbn edit "task-id" -r "relation"{b}
    Add or modify a relation. The relation should be an existing task id, optionally prefixed with a relation type.
    Examples:
      "blocks my-task-1"
      "duplicates my-task-2"

  {b}kanbn edit "task-id" --unset "field"{b}
    Remove a metadata field from a task. This option can be repeated to remove several fields.
    Available fields: started, completed, due, plannedStart, plannedFinish, assigned, progress, tags,
    plus any custom fields declared in the customFields project option.
    Examples:
      {b}kanbn edit "task-id" --unset completed{b}
        Reopen a completed task by clearing its completed date.
      {b}kanbn edit "task-id" --unset started --unset completed{b}
        Clear both dates.
    A field cannot be set and unset in the same command. If a task is moved into a started or
    completed column by the same command, the unset is applied afterwards, so it wins.

  {b}kanbn edit --<custom field name> <value>{b}
    Add or modify a custom metadata field.
    The custom field must be declared in the customFields project option.

  {b}kanbn edit --remove-<custom field name>{b}
    Remove a custom metadata field.

  {b}kanbn edit "task-id" --board "board-slug"{b}
  {b}kanbn edit "task-id" -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.

  {b}kanbn edit "Buy milk"{b}
    Editing a simple task - a line in a column that isn't a task link - promotes it to a real task
    file first, and then applies the edit. The new task is created in the column the line was in,
    with a created date as of the promotion. There is no way back.

Boards can declare {b}actions{b} - rules that fire when a task changes, e.g. "when this enters In
Progress, assign it to me and tag it active". See {b}docs/actions.md{b}.

  {b}kanbn edit --no-actions{b}
    Run without firing any action rules. {b}KANBN_NO_ACTIONS=1{b} does the same for a whole shell.