Search & Filtering

Basic toolbar search

Type any text in the search bar to filter cards by title, body, labels, and metadata values. Exact substring match is the default.

kl list --search "release"

Fuzzy mode

Enable the Fuzzy toggle in the web UI or pass --fuzzy in the CLI to match near-misses. Useful for typos and partial keywords.

kl list --search "authetication" --fuzzy

Metadata token filters

Use meta.field: value tokens to filter by any card metadata field. Tokens are substring-matched and case-insensitive. Combine multiple tokens in one query.

kl list --search "meta.team: backend"
kl list --search "meta.sprint: Q2 meta.team: frontend"

In the web UI, mixed queries split into removable chips so you can drop one constraint without clearing the whole search.

Clickable label and metadata filters

Click a label badge on a board card or in the card detail panel to instantly inject a label filter. Click the filter icon next to a rendered metadata value to inject a meta.* token into the shared search box — no typing required.

Structured filter flags (CLI & API)

For scripts and automation, target-filter flags are more legible than embedding tokens in a search string:

kl list --status todo --priority high --assignee alice
kl list --label "security" --meta sprint=Q2 --meta links.jira=PROJ-42

Due date filters

Toolbar shortcuts for common date-relative views: Overdue, Due Today, Due This Week, No Due Date.

Column-level sorting

Sort cards within any column by priority, due date, or creation date from the column menu. Sorting applies visually without moving cards to different status columns.

URL persistence

In standalone mode, the active board, selected card, applied filters, search query, and fuzzy mode are persisted in browser history and deep links. Bookmark a filtered view or share a link with a pre-applied search state.