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

# Projects

> Group related tasks into projects and keep work organized.

## What is a project?

A project is a named collection of related tasks. Use projects for ongoing efforts — a product launch, a home renovation, a work initiative — where tasks share context and belong together.

## Creating a project

From the task list, click the project selector on any task and type a new project name. Tandem creates it automatically.

From the CLI:

```bash theme={null}
tandem project create "Home Renovation"
```

## Assigning tasks to a project

Edit any task and select a project from the dropdown. You can also assign tasks in bulk from the CLI:

```bash theme={null}
tandem project set <task-id> "Home Renovation"
tandem project setall "Home Renovation" <id1> <id2> <id3>
```

## Project categories

Each project has its own category list. Categories help you label tasks within the project — for example, a software project might have categories like Frontend, Backend, CLI, and Design.

**Setting categories from the CLI:**

```bash theme={null}
# View current categories
tandem project categories list "My Project"

# Add a category
tandem project categories add "My Project" Backend

# Replace all categories at once
tandem project categories set "My Project" Frontend Backend Database DevOps Design
```

When you edit a task in a project, the category dropdown shows that project's categories.

## General categories

Tasks not in any project use your general category list. Manage it from the CLI:

```bash theme={null}
tandem categories list
tandem categories add Finance
tandem categories set Finance Health Personal Work Admin
```

## Viewing tasks by project

The task list shows which project each task belongs to. You can filter or focus on a project from the task list sidebar.

## Renaming a project

From **Settings → Projects**, click the project name to rename it. All tasks in the project update automatically.

From the CLI:

```bash theme={null}
tandem project rename "Old Name" "New Name"
```

## Archiving a project

Archiving hides a project and all its tasks from your main view without deleting anything. Archived projects can be restored at any time.

From **Settings → Projects**, open the project menu and select **Archive**.

From the CLI:

```bash theme={null}
tandem project archive "My Project"
tandem project unarchive "My Project"
```

## Deleting a project

Deleting a project is permanent. When you delete a project, Tandem will ask what to do with its tasks:

* **Remove from project** — tasks stay in your list, unassigned from the project
* **Delete all tasks** — tasks are permanently deleted along with the project

From the CLI:

```bash theme={null}
tandem project delete "My Project"
```

You'll be prompted to choose what happens to the tasks before anything is deleted.

## Project members

Adding people to a project lets you share tasks, assign work, and collaborate. Project membership is coming in a future update — see [Connections](/connections) for the current collaboration model.