Skip to main content

What are tags?

Tags are freeform labels you attach to tasks. Unlike categories (which are structured and come from a predefined list), tags are open-ended — you create them on the fly to describe anything useful about a task. A task can have multiple tags. Common uses:
  • Contextwaiting, blocked, in-review
  • Typebug, feature, research, meeting
  • Peopledora, aarthi, team
  • Effortquick-win, deep-work, 5min

How tags are assigned

When you create a task through conversation, Tandem automatically infers 2–4 relevant tags from context. You can also add or edit tags directly in the task detail view. From the CLI:
tandem add "review the contract" --quick --tags "legal,finance,urgent"

Tags vs categories

TagsCategories
How many per taskManyOne
Where they come fromFreeform, anythingPredefined list per project or user
Best forCross-cutting labels, contextClassifying what type of work it is
Use categories to answer “what kind of task is this?” and tags to answer “what else is true about this task?”

Filtering by tag

You can filter your task list by tag to see all tasks with a given label — for example, all tasks tagged bug or waiting.