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

# Command Reference

> Every Tandem CLI command with examples.

## Tasks

### `tandem add <title>`

Create a new task. By default, opens an AI-assisted conversation to fill in details — Tandem asks clarifying questions, proposes a plan, and saves once you confirm.

```bash theme={null}
tandem add "prep for the board meeting"
tandem add "fix login bug"
```

Use `--quick` to skip the AI and create directly with flags:

```bash theme={null}
tandem add "quick note" --quick
tandem add "submit report" --quick --priority must-do --deadline 2026-06-15
```

**Flags (with `--quick`):**

* `-p, --priority` — `must-do` | `good-to-do` | `optional`
* `-d, --deadline` — date as `YYYY-MM-DD`
* `-t, --tags` — comma-separated tags

***

### `tandem list` / `tandem ls`

List your active tasks.

```bash theme={null}
tandem list
tandem list --today    # tasks due today
tandem list --week     # tasks due in the next 7 days
```

***

### `tandem done <id>`

Mark a task as complete. Use the first 8 characters of the task ID shown in `tandem list`.

```bash theme={null}
tandem done a1b2c3d4
```

***

### `tandem drop <id>`

Cancel a task.

```bash theme={null}
tandem drop a1b2c3d4
```

***

### `tandem task category <id> <category>`

Set the category on a task.

```bash theme={null}
tandem task category a1b2c3d4 Backend
```

***

### `tandem chat <message>`

Start an AI conversation to plan a task. Same as `tandem add` but more explicit.

```bash theme={null}
tandem chat "I need to prepare a demo for next week"
```

***

### `tandem today`

Show Tandem's suggested plan for today.

```bash theme={null}
tandem today
```

***

### `tandem ai <instruction>`

Natural language task management — update, retag, reschedule, or modify tasks using plain English.

```bash theme={null}
tandem ai "move all work tasks to next week"
tandem ai "tag everything without a category as Personal"
tandem ai "mark the AMEX task as must-do"
```

***

## Projects

### `tandem project list`

List all your projects.

```bash theme={null}
tandem project list
```

***

### `tandem project create <name>`

Create a new project.

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

***

### `tandem project set <task-id> <project>`

Assign a task to a project. Creates the project if it doesn't exist.

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

***

### `tandem project setall <project> <ids...>`

Assign multiple tasks to a project at once.

```bash theme={null}
tandem project setall "Home Renovation" a1b2c3d4 e5f6g7h8 i9j0k1l2
```

***

### `tandem project categories list <project>`

List categories for a project.

```bash theme={null}
tandem project categories list "TellTandem"
```

***

### `tandem project categories add <project> <category>`

Add a category to a project.

```bash theme={null}
tandem project categories add "TellTandem" Backend
```

***

### `tandem project categories set <project> <categories...>`

Replace all categories for a project.

```bash theme={null}
tandem project categories set "TellTandem" Frontend Backend Database CLI DevOps Design AI Marketing Business
```

***

## Categories

### `tandem categories list`

List your general categories (used for tasks not in any project).

```bash theme={null}
tandem categories list
```

***

### `tandem categories add <category>`

Add a general category.

```bash theme={null}
tandem categories add Finance
```

***

### `tandem categories set <categories...>`

Replace all general categories.

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

***

## Personality

### `tandem personality show`

Show your current personality setting.

```bash theme={null}
tandem personality show
```

***

### `tandem personality set <text>`

Set your personality in one command.

```bash theme={null}
tandem personality set "Be direct and terse. No pleasantries."
```

***

### `tandem personality edit`

Interactively edit your personality with a prompt.

```bash theme={null}
tandem personality edit
```

***

### `tandem personality clear`

Clear your personality and return to Tandem's default style.

```bash theme={null}
tandem personality clear
```

***

## Account

### `tandem login`

Authenticate via browser.

```bash theme={null}
tandem login
```

### `tandem logout`

Clear stored credentials.

```bash theme={null}
tandem logout
```

### `tandem whoami`

Show the currently logged-in account.

```bash theme={null}
tandem whoami
```