Configuration¶

TaskRepo configuration is stored in ~/.TaskRepo/config as a YAML file.

Configuration File¶

Location: ~/.TaskRepo/config

Example Configuration¶

parent_dir: ~/tasks
default_priority: M
default_status: pending
default_assignee: null
default_github_org: null
default_editor: null
sort_by:
  - priority
  - due
cluster_due_dates: false

Configuration Options¶

parent_dir¶

Type: Path
Default: ~/tasks

Directory where task repositories are stored.

parent_dir: ~/my-tasks

default_priority¶

Type: String (H/M/L)
Default: M

Default priority for new tasks.

default_priority: H

default_status¶

Type: String (pending/in-progress/completed/cancelled)
Default: pending

Default status for new tasks.

default_status: pending

default_assignee¶

Type: String (GitHub handle) or null
Default: null

Automatically assign new tasks to this user.

default_assignee: "@alice"

default_github_org¶

Type: String or null
Default: null

Default GitHub organization for new repositories.

default_github_org: "myorg"

default_editor¶

Type: String or null
Default: null

Default text editor for editing tasks.

default_editor: "vim"

sort_by¶

Type: List of strings
Default: ["priority", "due"]

Order to sort tasks. Available fields: - priority, due, created, modified - status, title, project, assignee - Prefix with - for descending (e.g., -priority)

sort_by:
  - due
  - -priority
  - created

cluster_due_dates¶

Type: Boolean
Default: false

Group tasks by time buckets instead of exact dates.

cluster_due_dates: true

Interactive Configuration¶

Edit configuration interactively:

tsk config

View current configuration:

tsk config-show

Editor Selection Priority¶

When editing tasks, the editor is selected in this order:

1. CLI flag: tsk edit 123 --editor nano
2. Environment variable: $EDITOR
3. Config file: default_editor
4. Fallback: vim

Assignee Sorting¶

Special sorting modes for assignees:

Basic Alphabetical¶

sort_by:
  - assignee

Preferred User First¶

sort_by:
  - assignee:@alice  # @alice's tasks first
  - priority

Migration¶

Legacy config file (~/.taskreporc) is automatically migrated to ~/.TaskRepo/config on first run.

See Also¶

• Task Management - Managing tasks
• API Reference - Complete config reference