> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cogniagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Tasks
> A task is a private, chat-first run in Cowork — bind it to a worker or start one from scratch.
A task is where the work actually happens in Cowork: one private conversation between you and a worker (or a bare model, if you skip the worker) that can read files, run code, and call connections until the job is done.
## What a task is
Think of a task as a single chat thread with a to-do attached to it. Every task belongs to exactly one person — the workspace member who started it — and it stays theirs for its whole lifetime.
A task is the **run record**, separate from the **worker**, which is the reusable, durable definition (instructions, skills, assets, and connections) a task can run inside of. See [Core concepts](/cowork/concepts) for how the two fit together, and [Workers](/cowork/workers/overview) for what a worker is made of.
## Worker-bound vs. worker-less tasks
There are two ways to start a task, and where you click determines what it inherits:
| | Worker-bound task | Worker-less task |
| ------------ | -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Started from | "New task" on a worker's page | The top-level **+ New task** button |
| Context | Copies the worker's files; runs with its instructions, skills, assets, and connections | Starts empty — no worker instructions or skills apply |
| Model | Uses [the worker's configured model](/cowork/workers/overview) | You pick a model up front, since there's no worker to inherit one from |
| Tools | The worker's connections, plus built-ins | Standard built-in tools only (connecting to an integration, searching the web, and the like) |
```mermaid theme={null}
flowchart LR
A["+ New task (top level)"] --> B[Worker-less task]
B --> C[Pick a model]
C --> D[Chat opens — no worker context]
E["+ New task (on a worker)"] --> F[Worker-bound task]
F --> G[Copies the worker's files]
G --> H[Chat opens — worker's instructions, skills, connections, model]
```
A worker-less task (sometimes called a workspace task) is the equivalent of opening a fresh chat — useful for one-off work that doesn't need a dedicated worker. A worker-bound task instead runs as that worker, with everything it knows and can do already loaded.
Both kinds of task run in the same cowork session and are private to you either way — attaching a worker changes what the task can do, not who can see it.
## Task lifecycle
A task moves through a small set of plain-language states:
| Status | What it means |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Idle** | Open, but nothing is currently in progress — there's nothing you need to do right now. |
| **Working** | The worker is actively taking steps: reading files, running code, calling connections. |
| **Needs you** | Paused for you — either it's asking a question or it's waiting on your approval for a risky action. See [Human-in-the-loop](/cowork/collaborate/human-in-the-loop). |
| **Done** | The worker wrapped up the work it was asked to do. |
```mermaid theme={null}
stateDiagram-v2
state "Needs you" as NeedsYou
[*] --> Idle
Idle --> Working: you send a message
Working --> NeedsYou: asks a question or needs approval
NeedsYou --> Working: you reply or approve
Working --> Done: worker wraps up
Done --> Working: you send another message
```
Done isn't a dead end. Send a finished task a new message and it picks the same conversation back up, with all its history and files intact — you never need to start a new task just to continue one.
## The cowork session
Opening a task puts you in the **cowork session** — a two-pane view built around the conversation:
* **Chat (left)** — the spine of the task. You and the worker talk through the goal, and its steps (files touched, code run, connections called) appear inline as plain-language lines, not a raw terminal feed.
* **Files & preview panel (right)** — a live view of the task's own files as the worker creates and edits them, with previews and an inline editor for common types like text, code, images, and spreadsheets.
The panel and the loop behind the chat are covered in depth elsewhere:
* [Execution, sandbox & files](/cowork/tasks/execution) — where a task's code actually runs and how its files are stored.
* [The agentic loop](/cowork/loop/agentic-loop) — what happens, step by step, each time the worker takes a turn.
## Privacy
A task is visible only to the person who started it — never to other workspace members, and never automatically to an admin. This is the one place Cowork's default openness stops: workers, their skills, and workspace-scoped files are shared with everyone in the workspace, but a task and its task-scoped files belong to its owner alone.
## Where tasks live: the list, and the board to come
Your tasks live on the **Tasks** home — a single list, newest activity first, with a pinned **needs you** group above your **recent** tasks so the ones waiting on you never get buried.
A Kanban-style board view — swimlanes per worker, work-in-progress limits, drag-to-update — is on the roadmap as a richer, optional view over the same tasks. It isn't available today; the list is the current home for every task, worker-bound or not.
## Next steps
See where a task's code runs and how its files are kept in sync.
Follow what happens on each turn a worker takes inside a task.
Understand approvals and the "needs you" state in detail.
See what a worker brings to the tasks it runs.