> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telltandem.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags

> Label tasks with freeform tags for flexible filtering and context.

## 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:

* **Context** — `waiting`, `blocked`, `in-review`
* **Type** — `bug`, `feature`, `research`, `meeting`
* **People** — `dora`, `aarthi`, `team`
* **Effort** — `quick-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:

```bash theme={null}
tandem add "review the contract" --quick --tags "legal,finance,urgent"
```

## Tags vs categories

|                      | Tags                          | Categories                          |
| -------------------- | ----------------------------- | ----------------------------------- |
| How many per task    | Many                          | One                                 |
| Where they come from | Freeform, anything            | Predefined list per project or user |
| Best for             | Cross-cutting labels, context | Classifying 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`.