Tandem CLI

Task management from your terminal. The same tasks, priorities, and AI features you use in Tandem — without leaving the command line.

Install

npm install -g @telltandem/cli

Requires Node 18+.

Getting started

tandem login

This opens your browser so you can sign in to your Tandem account. Once you authorize, the CLI stores a long-lived token locally and you're ready to go.

Commands

Tasks

tandem list                   # All open tasks
tandem list --today           # Tasks due today
tandem list --week            # Tasks due in the next 7 days

tandem add "Write the report" -p must-do -d 2026-06-10 -t work,writing
# -p priority: must-do | good-to-do | optional (default: good-to-do)
# -d deadline: YYYY-MM-DD
# -t tags: comma-separated

tandem done <id>              # Mark a task complete
tandem drop <id>              # Cancel a task

IDs are the first 8 characters shown in tandem list.

Today's plan

tandem today

Asks Tandem's AI what you should focus on today, factoring in deadlines and priorities.

AI updates

tandem ai "move all work tasks to next week"
tandem ai "tag everything without a category as Personal"
tandem ai "add Finance tag to all tasks with budget in the title"

Natural language instructions applied across your task list.

Projects

tandem project list                        # List all projects
tandem project create "My Project"         # Create a project
tandem project set <id> "My Project"       # Assign one task to a project
tandem project setall "My Project" <ids…>  # Assign multiple tasks at once

Account

tandem whoami    # Show the logged-in email
tandem logout    # Remove stored credentials

Configuration

By default the CLI talks to https://telltandem.com. To point it at a self-hosted instance:

TANDEM_URL=https://your-tandem.example.com tandem login

The auth token is stored in ~/.config/tandem/auth.json.

Revoking access

To revoke CLI access, go to Settings → CLI Tokens in the Tandem web app and click Revoke.

License

MIT