> ## Documentation Index
> Fetch the complete documentation index at: https://docs.traycer.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tasks and Workspace Folders

> Understand Tasks, Task tabs, and workspace folders in Traycer Desktop.

## Task

A **Task** is the top-level container for a piece of work in Traycer. It maps to an outer Task tab and keeps related chats, panels, artifacts, terminal sessions, files, and git diff together.

## Workspace Folder

A **workspace folder** is a local code folder or repo that Traycer can work against. A Task can be associated with one or more workspace folders.

When a workspace folder is a git repository, Traycer can run agent work in the folder itself or in a git worktree. See [Worktrees](/concepts/worktrees).

## How a Task Is Organized

| Part                  | Purpose                                                                                                    |
| --------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Workspace folders** | The local code folders Traycer can inspect or modify.                                                      |
| **Panels**            | Sidebar navigators for chats, artifacts, terminals, files, git diff, sharing, and comments.                |
| **Canvas tabs**       | The work surfaces opened from panels, such as chats, terminal agents, artifacts, file previews, and diffs. |
| **Artifacts**         | Durable specs, tickets, stories, and reviews that preserve intent and progress.                            |

Learn the sidebar panel list in [Panels](/panels).