Task Management¶

Master the art of managing tasks with TaskRepo.

Creating Tasks¶

Interactive Mode¶

The easiest way to create tasks:

tsk add

You'll be prompted for all task details with autocomplete and validation.

Non-Interactive Mode¶

Create tasks with command-line flags:

tsk add -r work \
  -t "Fix authentication bug" \
  -p backend \
  --priority H \
  --assignees @alice,@bob \
  --tags bug,security \
  --due "next week"

Common Options¶

Flag	Description
`-r, --repo`	Repository name
`-t, --title`	Task title (required)
`-p, --project`	Project name
`--priority`	Priority (H/M/L)
`--assignees`	Comma-separated GitHub handles
`--tags`	Comma-separated tags
`--due`	Due date (natural language)
`--links`	Comma-separated URLs

Viewing Tasks¶

List All Tasks¶

tsk list

Filter by Repository¶

tsk list --repo work

Filter by Status¶

tsk list --status pending
tsk list --status in-progress

Filter by Priority¶

tsk list --priority H

Combine Filters¶

tsk list --priority H --status pending --repo work

Show Completed Tasks¶

tsk list --all

Updating Tasks¶

Edit Task¶

tsk edit 1

Opens task in your editor.

Change Status¶

tsk in-progress 1
tsk done 1
tsk cancelled 1

Extend Due Date¶

tsk ext 1 1w         # Extend by 1 week
tsk ext 1 "next month"  # Set to next month

Batch Operations¶

Most commands support multiple tasks:

# Space-separated
tsk done 1 2 3

# Comma-separated
tsk done 1,2,3

# Works for: done, edit, del, move, archive

Organizing Tasks¶

Projects¶

Group related tasks:

tsk add -r work -t "Implement API" -p backend
tsk add -r work -t "Design UI" -p frontend

List by project:

tsk list --project backend

Tags¶

Cross-cutting categorization:

tsk add -r work -t "Fix bug" --tags bug,urgent,security

List by tag:

tsk list --tag urgent

Assignees¶

Track responsibility:

tsk add -r work -t "Review PR" --assignees @alice

List by assignee:

tsk list --assignee @alice

Task Dependencies¶

Tasks can depend on other tasks:

depends:
  - 'b4e8f3a1-5c6d-4e2f-8a9b-1c2d3e4f5a6b'

Full dependency support coming soon

Task Links¶

Associate URLs with tasks:

tsk add -r work -t "Fix bug" \
  --links https://github.com/org/repo/issues/123,https://docs.example.com/api

Supported link types: - GitHub issues/PRs - Email threads - Documentation - Any URL

Archiving¶

Archive completed tasks:

tsk archive 1

View archived tasks:

tsk archive

Unarchive tasks:

tsk unarchive 1

Searching¶

Search task content:

tsk search "authentication"

Search with filters:

tsk search "bug" --priority H --repo work

Moving Tasks¶

Move tasks between repositories:

tsk move 1 personal

Move multiple tasks:

tsk move 1,2,3 work

Tips & Tricks¶

Default Assignee

Set default_assignee in config to auto-assign tasks to yourself

Natural Language Dates

Use dates like "tomorrow", "next week", "Nov 15"

Use the TUI

Launch tsk tui for visual task management

Batch Complete

Filter tasks then use multi-select in TUI to batch complete