Skip to main content

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