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

# Tasks

> How to create, manage, and organize your tasks in Tandem.

## Creating a task

Type what you need to get done in the chat box. Tandem's AI will ask clarifying questions and propose a plan — confirm it and the task is saved with full detail.

You can also create tasks directly from the CLI:

```bash theme={null}
tandem add "submit quarterly report"
```

This opens the same AI-assisted flow in your terminal.

## Task fields

Every task has the following fields:

| Field             | Description                                         |
| ----------------- | --------------------------------------------------- |
| **Title**         | What needs to get done                              |
| **Priority**      | `must-do`, `good-to-do`, or `optional`              |
| **Deadline**      | Hard deadline (date) — tasks past this are overdue  |
| **Soft deadline** | Target date — a softer goal, not a hard cutoff      |
| **Category**      | A single category from your project or general list |
| **Tags**          | Free-form labels for filtering and context          |
| **Notes**         | Background context, constraints, decisions          |
| **Subtasks**      | Ordered steps within the task                       |

## Priorities

* **Must-do** — non-negotiable. Tandem always surfaces these in your Today plan.
* **Good-to-do** — important but flexible. Tandem includes these when there's capacity.
* **Optional** — nice to have. Appears in your list but won't drive your daily plan.

## Editing a task

Click any task to open it. All fields are editable inline — title, priority, deadline, category, tags, and subtasks. Changes save automatically.

## Completing a task

Check off a task to mark it complete. Completed tasks are hidden from the active list but accessible via the **Show completed** button, which displays a count of completed tasks in the current view.

## Subtasks

Subtasks are generated automatically when you create a task through conversation. Each subtask has its own status and can be checked off independently. You can add, edit, or remove subtasks from the task detail view.

## Categories and tags

**Categories** come from your project's category list (if the task is in a project) or your general category list. A task has one category.

**Tags** are freeform and a task can have many. Use tags for cross-cutting concerns like `urgent`, `waiting`, or `recurring`.

## Recurring tasks

Tandem supports recurring tasks natively. Just describe the recurrence when creating a task:

```
remind me to pay my AMEX bill on the 28th of each month
```

Tandem will set up the recurrence automatically. When you complete a recurring task, it schedules the next occurrence.

## Views

Tasks can be filtered by:

* **Today** — tasks due today (including overdue)
* **7 days** — tasks due in the next 7 days
* **30 days** — tasks due in the next 30 days
* **All** — everything active

Completed tasks in the **7 day** and **30 day** views show tasks whose deadline falls in that window — even if you completed them early.