Search & Filters¶

Master task discovery with search and filtering.

Text Search¶

Basic Search¶

tsk search "authentication"

Searches across: - Task titles - Descriptions - Project names - Tags

Case Insensitive¶

All searches are case-insensitive:

tsk search "BUG"  # Matches "bug", "Bug", "BUG"

Search with Filters¶

Combine search with filters:

tsk search "auth" --priority H
tsk search "bug" --repo work
tsk search "api" --status pending --project backend

By Repository¶

tsk list --repo work
tsk list -r personal

By Status¶

tsk list --status pending
tsk list --status in-progress
tsk list --status completed
tsk list --status cancelled

Short form:

tsk list -s pending

By Priority¶

tsk list --priority H  # High
tsk list --priority M  # Medium
tsk list --priority L  # Low

By Project¶

tsk list --project backend
tsk list -p frontend

By Assignee¶

tsk list --assignee @alice
tsk list -a @bob

By Tag¶

tsk list --tag bug
tsk list -t urgent

Combining Filters¶

Stack multiple filters:

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

All filters must match (AND logic).

Include Completed¶

By default, search excludes completed tasks.

Include all tasks:

tsk search "bug" --all
tsk list --all

Filter Examples¶

Urgent Work Items¶

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

My Pending Tasks¶

tsk list --assignee @alice --status pending

Backend Bugs¶

tsk list --project backend --tag bug

Overdue Tasks¶

# Use TUI and filter by due date countdown (red dates)
tsk tui
# Press / to filter

Interactive Filtering¶

TUI Filters¶

Launch TUI and press /:

tsk tui
# Press /
# Type: authentication
# Press Enter

Filters work on visible tasks.

Search vs List¶

tsk search: Text query + filters - Searches content across fields - Excludes completed by default

tsk list: Filters only - No text search - Shows all statuses

Advanced Patterns¶

Find All High Priority¶

tsk list --priority H

Find Team's Tasks¶

tsk list --repo team-project --status pending

Find Tagged Items¶

tsk list --tag urgent --tag blocked

Note: Currently shows tasks with ANY tag (OR logic)

Saved Filters (Coming Soon)¶

Future feature: Save frequently used filters.

# Future:
tsk filter save urgent --priority H --status pending
tsk filter run urgent

Tips & Tricks¶

Fuzzy Search

Search matches partial strings: "auth" finds "authentication"

Filter Then Operate

Use filters to find tasks, then operate on them

tsk list --priority H  # Find high priority
tsk done 1,2,3        # Complete them

TUI for Visual Filtering

Use tsk tui with / for visual, interactive filtering

Combine with Pipe

tsk list --priority H --repo work | grep "API"

Filter Reference¶

Filter	Short	Values	Example
`--repo`	`-r`	Repository name	`--repo work`
`--status`	`-s`	pending/in-progress/completed/cancelled	`--status pending`
`--priority`		H/M/L	`--priority H`
`--project`	`-p`	Project name	`--project backend`
`--assignee`	`-a`	@username	`--assignee @alice`
`--tag`	`-t`	Tag name	`--tag bug`
`--all`		Include completed	`--all`