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

# CLI Overview

> Manage Tandem from your terminal.

The Tandem CLI lets you create and manage tasks, projects, and settings without leaving your terminal. It uses the same AI as the web app — so `tandem add` has a full conversation with you before saving anything.

## Installation

```bash theme={null}
npm install -g @telltandem/cli
```

Requires Node.js 18 or later.

## Authentication

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

This opens a browser window to authenticate. Your session is stored locally and stays valid until you log out or revoke the token.

```bash theme={null}
tandem logout    # clear stored credentials
tandem whoami    # show the current logged-in account
```

## Self-hosted

If you're running a self-hosted instance, set the `TANDEM_URL` environment variable:

```bash theme={null}
TANDEM_URL=https://your-instance.com tandem login
```

## Revoking CLI access

CLI tokens can be revoked from **Settings → CLI Tokens** in the web app. Each device gets its own token — revoking one doesn't affect others.

## Next steps

<Card title="Command reference" icon="terminal" href="/cli/commands">
  Full list of every CLI command with examples
</Card>