# Chat, workspaces, and tasks

> Use the task list, pick an agent and workspace in the composer, create folder or repository workspaces, and run several tasks in parallel.

Section: Chat and tasks · Updated: 2026-11-19 · Canonical: https://nested.me/docs/chat

Nested organizes work as tasks, not as one long chat. The sidebar is your team’s task list across every agent, so you can see at a glance what needs you and what is still running. Workspaces keep topics from mixing; tasks are the actual conversations.

## Before you start

- Have at least one agent. If you have none, the home screen shows **New agent**; see [Deploy an agent](https://nested.me/docs/deploy).
- On desktop, you can collapse and resize the sidebar to give the thread more room.

## The task list

The desktop sidebar holds:

| Part | What it does |
| --- | --- |
| **Search tasks** and **New task** | Find a task by title, or start a blank one |
| **Agent** and **Workspace** filters | Narrow the list to one agent or one workspace; **Clear filters** resets them |
| **Active** tab | **Needs you** at the top, then **Running** |
| **Archived** tab | Closed tasks, filterable by kind: Chat, Scheduled, Hook, Automation, Formula, Startup, or All |
| **Agents** group | Each agent with **New task**, sign-in, and settings actions; **New agent** and **All agents** at the end |
| Account control | Your account menu, at the foot of the sidebar |

On a phone, the **Tasks** tab shows the same list with an agent strip on top (**All agents** plus each agent).

## Steps

1. Select **New task** in the sidebar, or **New task** on an agent in the **Agents** group.
2. In the composer, choose the agent in the agent picker (**Choose agent**) and the workspace in the workspace picker (**Choose workspace**).
3. Write your message. Enter sends; Shift+Enter makes a new line; the mic dictates.
4. While the agent works, you can keep typing — messages wait in the queue and send after the current turn. Press Esc to stop the turn.
5. To work in parallel, select **New task** again. Each task is its own row in the list.
6. When the work is done, select **Complete** in the task header. To stop the agent at once, select **Abort**.

## Workspaces

A workspace is a named topic for an agent’s tasks. Create one from the workspace picker with **New workspace**:

| Workspace type | What it is | Good for |
| --- | --- | --- |
| **Open folder** | A scratch space on the agent | Research, writing, one-off scripts |
| **One repository** | Checks a repository out for every task | Code changes, reviews, fixes |

For **One repository**, search a **Repository** (or type `owner/repo`) and optionally a **Branch**. Nested reads and clones the repository through the GitHub connector, so connect it first under [Connectors](https://nested.me/docs/connectors). Repository tasks can run in the main checkout (**Local**) or in a separate **Worktree**; see [The task panel](https://nested.me/docs/task-panel).

> [!TIP]
> Keep one workspace per project or thread of work. Tasks stay grouped, and the **Workspace** filter becomes useful.

## The task options menu

The task header shows **Complete** and **Abort**. Everything else lives in **Task options** (⋯):

- **New subtask** — split work off this task onto a lane under it.
- **Runbooks** — the agent’s turn-by-turn log.
- **Share…** — a public, read-only link. See [Share, export, and runbooks](https://nested.me/docs/share-export).
- **Export history…** — the conversation as Markdown.

## On a phone

New tasks and **Expand composer** open a full-screen sheet so the keyboard has room. Replies to an open task are written inline under the thread. **Task details** opens the task panel as a sheet.

## Example

In the “Launch” workspace, start “Draft the announcement” on your writing agent. Then select **New task** and start “Review the checklist” on the same agent. Both appear under **Running**. Filter by the “Launch” workspace to see only those two.

## Questions

### How do I run tasks in parallel in Nested?

Select **New task** again while another task runs. Each task is independent and appears as its own row in the task list.

### Where do I pick the agent for a task?

In the composer’s agent picker. The sidebar lists tasks across all agents; use the **Agent** filter to narrow it.

### Why can’t I choose a repository for a workspace?

Repository workspaces need the GitHub connector. Connect it on the Connectors page, then try **New workspace** again.

[Open in Nested](https://app.nested.me/)

## Related

- [The composer](https://nested.me/docs/composer)
- [Needs you: tasks waiting on you](https://nested.me/docs/attention)
- [The task panel, changes, and worktrees](https://nested.me/docs/task-panel)
- [How tasks work](https://nested.me/docs/tasks-lifecycle)
