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.
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.
- 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#
- Select New task in the sidebar, or New task on an agent in the Agents group.
- In the composer, choose the agent in the agent picker (Choose agent) and the workspace in the workspace picker (Choose workspace).
- Write your message. Enter sends; Shift+Enter makes a new line; the mic dictates.
- 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.
- To work in parallel, select New task again. Each task is its own row in the list.
- 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. Repository tasks can run in the main checkout (Local) or in a separate Worktree; see The task panel.
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.
- 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.